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PREFACE 


MANUAL OBJECTIVES 


The RSX-11M/M-PLUS MCR Operations Manual provides information needed 
to operate and control an RSX-11M/M-PLUS system. It supplies an 
introduction to the basic concepts of MCR and describes the use of MCR 
as the terminal interface with the RSX-11M/M-PLUS operating system. 


The manual identifies two types of users: privileged and 
nonprivileged. MCR provides privileged users functions that control 
and modify system operation as well as functions that permit program 
development and system maintenance. MCR provides nonprivileged users 
only those functions required for program development and _ local 
maintenance. 


INTENDED AUDIENCE 


The RSX-11M/M-PLUS MCR Operations Manual does not attempt to train 
operators. The manual assumes that the reader is familiar with 
computer operating procedures, both real-time and batch, and that’ the 
reader has experience operating terminal devices. 


An "operator" is broadly defined as anyone who interfaces directly 
with RSX-11M/M-PLUS to perform a task. This broad definition is used 
because of the many and varied settings in which RSX-11M/M-PLUS 
operates; some settings do not require an operator in the 
conventional sense of the term. 


RSX-11S is a compatible subset system of RSX-11M/M-PLUS. Thus, this 
manual can also be used as a reference document for RSX-11S. 


STRUCTURE OF THE DOCUMENT 
Chapter 1 describes MCR and gives a summary of the commands. 


Chapter 2 discusses basic concepts of the RSX-11M/M-PLUS file system 
(Files-11) and also describes many system conventions, such as device 
and task naming conventions. 


Chapter 3 supplies detailed descriptions of all the MCR commands. The 
commands are in alphabetical order. 


Chapter 4 discusses the indirect command processor (Indirect) and 
explains the use of indirect command files. Directives to the 
indirect command processor appear in alphabetical order. 


Appendix A lists, in alphabetical order, the MCR and Task Termination 
Notification program (TKTN) messages that can be returned by the 


meee kam 
syscen. 
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PREFACE 


ASSOCIATED DOCUMENTS 


Other documents related to RSX-11M/M-PLUS are briefly described in the 
respective documentation directories. 


Although the RSX-11M/M-PLUS MCR Operations Manual is primarily 
self-contained, the reader should be familiar with system generation 
options and features to understand the function of this manual in the 
context of RSX-11M/M-PLUS as a whole (see either the RSX-11M or 
RSX-11M-PLUS System Generation and Installation Guide). 


SS _ _-_——— ——e 


CONVENTIONS USED IN THIS DOCUMENT 


A symbol with a 1- to 3-character abbreviation indicates that you 
press the corresponding key on the terminal, for example, or 
ES) . 


The symbol €TRLIn) indicates that you must press the key labeled CTRL 
while you simultaneously press another key: for example, @mRUZ) i, 
€TRLIR) ’ GiRL/U) - In examples, these three control keyS are _ shown 
as “Z, “R, “U, respectively, because that is how the system echoes 
them. 


Uppercase letters and words indicate that you should enter the letter 
or word exactly as shown. Lowercase letters and words indicate that 
you are -to substitute a word or value. 


Square brackets ([]) indicate optional entries in a command line or 
file specification. When you enter an option, the brackets are not 
included. 


Square brackets are also a part of the User Identification Code and 
User File Directory syntax ([group,member]). When you use a UIC or 
UFD (in a file specification, for example), the brackets must be 
included. 


Braces ({}) indicate a choice of required entries for a command line. 
You can use any of the entries enclosed in the braces, but you must 
specify one of them. 


Red ink in examples indicates input that you type on the terminal. 
Shaded portions of text describe only one operating system. Pink 
shading indicates that the text pertains only to RSX-11M systems. 


Gray shading indicates that the text pertains only to RSX-11M-PLUS 
systems. 


vill 


SUMMARY OF TECHNICAL CHANGES 


This revision of the RSX-11M/M-PLUS MCR Operations Manual contains 


changes and additions included in the RSX-11M V4.0 and RSX-11M- PLUS 
V2.0 operating systems. 


Note that not all of the new technical features are available in 
single-user MCR. 


The following are new or revised MCR commands: 


ALL New keyword: /TYPE=RXnn. Allocates the first available 
device of the specified type. 


BLK New command. Blocks an installed task and declares it 
ineligible to execute or compete for memory. Blocked tasks 
must be unblocked (with the new UNBLOCK command) or aborted. 
The BLOCK command replaces the STOP command. 


BOOT Now allows booting of an RSX-11M-PLUS system from an RSX-11M 
host and vice versa. 


BRO Now includes system and DECnet node names in the system 
identification, and will not broadcast messages to terminals 
that have disabled the broadcast option with SET /NOBRO. 


BYE Now supports silent logouts. 


New keyword: /[NO]HOLD, which specifies whether BYE should 
leave a terminal connected after it is logged out. 


CLI New command. Sets up for use a command line interpreter 
(CLI) other than MCR, such as DCL or a uSer-written CLI. 


CLO Now nonprivileged instead of privileged. 


DCL New command. Allows you to issue DIGITAL Command Language 
(DCL) commands from a terminal that is set to MCR. 


DEBUG — _ (RSX-11M-PLUS ae Be a a task oe ‘to a 
le Oo gebugg ing = aid uch as ODT) so “that the ae can be 
. debugged. aes SANS 

DEV New format: DEV /ddnn:, which displays information about a 
specific device. 

DMO Now checks for installed tasks on a_ device. If any such 
tasks are present, displays a message and dismounts the 
device. 

The /LOCK keyword can now be used on RSX-11M. New options 


for the keyword are Unload and Nounload. 


1x 


HELLO 


HELP 


HOME 


INI 


SUMMARY OF TECHNICAL CHANGES 


LOGIN can now be used aS a synonym for HELLO. 


The command now supports silent logins on systems with 
multi-CLI support, and the system or DECnet node name is 
included in the system identification. There is also a 
timeout count for responding to the default prompt. 


Now displays, because of extended CLI capability, the 
general help file for the command line interpreter to which 
the terminal is set. 


New keywords are: 
/CLI Directs HELP to the help file for the 


specified command line interpreter in 
LB: [1,2] cliname.HLP. 


/DCL Specifies that the help text begins in 
LB: [1,2]DCL.HLP. 

/FIL Specifies any file where help text is 
located. 

/GRO Instructs HELP to use _ {[group,1]HELP.HLP on 


the default volume as the root help file. 


/LOC Displays the text contained in HELP.HLP in 
the default directory on the default volume 
(synonymous with HELP $%). 


/MCR Specifies that the help text begins in 
LB: [1,2]MCR.HLP. 


/OUT Saves the text of the help file (or files) in 
a Specified file. 


/ XXX Specifies that the help text begins in 
LB: [1,2]xxx.HLP, where xxx is the name of the 
command line interpreter. 


New command. Modifies certain fields in the home block of a 
Files-1ll disk volume. 


Note that if you install an old version of the INI task 
(RSX-1L1M V3.2/RSX-11M-PLUS V1.0 or earlier) using the name 
HOM, the volumes will be initialized when you use the HOME 
command. 


Now supports 65K files on volumes. These volumes are not 
backwards compatible from RSX-11M V4.0 or from RSX-11M-PLUS 
V2.0. 

New or revised keywords are: 


/ ACCESS Specifies the access protection for a 
magnetic tape volume. 


/DEN Now accepts 6250 bpi as the density for a 
TU78 magnetic tape. 


/OWNER Specifies the owner of a magnetic tape volume 
- g 
in a format other than as a UIC. 


INS 


LOA 


MOU 


SUMMARY OF TECHNICAL CHANGES 


New keywords are: 


/CLI Installs a task as a command lin 
interpreter. A CLI task must be neces 
before the CLI can be used. 

/IO0P Specifies that a puivilege? task can overma 

p 


the I/O page. 


Now correctly loads the KMC line printer driver with 
multiple controllers. 


Now allows names with special characters in them for 
magnetic tape volumes. 


New or revised keywords are: 


/BS Specifies block size for magnetic tape 
volumes. 

{CC Specifies record type for magnetic tape 
volumes, 

/DENS Now accepts 6250 bpi as a density for a TU78 


magnetic tape. 


/HDR3 Specifies whether an HDR3 label is to be 
written when creating new files. 


/ LABEL Specifies whether a magnetic tape volume is 
in ANSI format (/LABEL) or unlabeled 
(/NOLABEL) . 


/LOCK Specifies the default value for the DISMOUNT 
/LOCK keyword. 

/OVRACC Instructs the MOUNT command to override the 
protection for an ANSI magnetic tape volume. 

/PRO Specifies the volume protection for Files-1l 
disks. 

/ PUB Makes the volume accessible to all users, 


depending on the volume and file protection 
set for the volume. 


/RS Specifies number of characters in a_e record 
for magnetic tape volumes. 


x1 


SET 


SUMMARY OF TECHNICAL CHANGES 


New or revised keywords are: 


/ABAUD Enables autobaud detection for a terminal's 
remote dial-up line. 


/BRO Specifies whether a terminal will receive 
messages sent by the BROADCAST command. 


fCLI Displays or sets the default command line 
interpreter for a terminal (or terminals). 


Xlia 


MOU 
(Cont.) 


OPE 


PAR 
REM 


RUN 


SAV 


SUMMARY OF TECHNICAL CHANGES 


/ SHARE Specifies whether more than one user can 
mount the volume (/SHARE) or if it can be 
used by only one user (/NOSHARE). 


/TR Specifies the kind of character translation 
used in read and write operations on an 
unlabeled magnetic tape volume. 


/VOL Specifies the Volume Identifier for an ANSI 
magnetic tape. 

/WAIT Specifies whether operator assistance is 
required for performing a mount operation. 

/WIN Now also accepts the following options: 
USER:n, INDEX:n, (USER:n,INDEX:n), and FULL. 

/WRITE Specifies that a volume will be software 
write-enabled (/WRITE) or software 


write-locked (/NOWRITE). 


New formats for displaying the contents of a location in 
memory: ASCII, single-character ASCII, Radix-50, 
double-byte, and decimal. 


s only. Ne “Accesses - oe 
Sor. addresses” in the data 
APES task. ef 


ms paly. “Accesses s and 
of” “addresses 1 4 


an I- and D-space | t 


Now checks to see if an installed task is an active CLI. If 
so, it is not removed and an error message is displayed. 


New keywords are: 


/CMD Passes the specified command line to the task 
being run for processing. 


/EST Specifies whether or not a task will wait for 
spawned tasks to complete and for RUN to emit 
exit status. 


/INC Increments the address space allocated to a 
task that runs in a system-controlled 
partition. 

/IOP Specifies that a privileged task can overmap 


the I/O page. 


A saved RSX~1LIM-PLUS system is now bootable on RSX-11M. 
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SET 
(Cont.) 


STP 


SUMMARY OF TECHNICAL CHANGES 


(This keyword is. 


/NETUIC Specifies the UIC in which all DECnet-related 
tasks are stored. 


/PLCTL Displays or sets the pool limit parameters 
used by the Pool Monitor Task (PMT). 
/ REMOTE Now allows the setting of the initial baud 
2 g . e 
rate of a remote dial-up line for a terminal. 
/RNDC Defines the length of the Executive 
Shae 
round-robin scheduling interval. 
/RNDH Defines the highest priority that will be 
considered for Executive round-robin 


scheduling. 


/RNDL Defines the lowest priority that will be 
considered for Executive round-robin 
scheduling. 


/SWPC Defines the length of a single Executive 
Swapping interval. 


/SWPR Defines a priority range for Executive 
Swapping. 


/TERM New terminal types allowed: LA12, ULA34, 
bf 
LA38, LA1O0O, VT101, vT102, VT105, vT125, 
VT131, VT132. 


/ TOP Moves the top boundary of a system-controlled 
partition. 


The STOP command has been replaced by the BLOCK (BLK) 
command. 


xiii April 1983 


TAS 


UNB 


SUMMARY .OF TECHNICAL CHANGES 


Now accepts a task-name parameter. 


New keyword: /DEV, which displays information about tasks 
installed from a particular device. 


New command. Continues 


execution of a task previously 


stopped with the BLOCK command. 


Indirect Command Processor (Indirect) 


Indirect now accepts directives and command lines in lowercase as well 
as in uppercase. 


The following are new or revised directives: 


» ASK 


-ASKN 


eASKS 


-DATA 


.- ENABLE/ 
«DISABLE 


Now allows a default value and a timeout parameter 
to be specified in the command line. 


Now allows a timeout parameter to be specified in 
the command line. 


Now allows a default value and a timeout parameter 
to be specified in the command line. 


Now also allows a TAB after the command. 


New options 


for enabling and disabling are 


(default setting and default action): 


ATTACH 


CONTROL-Z 


DECIMAL 


DELETE 


DETACH 


DISPLAY 


ESCA PE-SEQ 


MCR 


OVERFLOW 


Enabled: Indirect attaches to TI: 
for comment lines. 


Disabled: Indirect exits when 
CTRL/Z is used in response to a 
-ASKx directive, 


Disabled: numeric symbols are 
created or redefined as octal. 


Disabled: the current command file 
is not deleted when Indirect exits. 


Enabled: Indirect detaches from 
the terminal when processing 
command lines. 


Enabled: Indirect displays the 
current fields for the .ASKx 
directives and "@ <EOF>". 


Disabled: Indirect does not attach 
to the terminal for escape-sequence 
recognition. 


Enabled: commands not processed by 
Indirect are passed to the default 
command line interpreter (CLI) of 
the terminal. 


Disabled: signed arithmetic in 
Numeric expressions is not allowed. 
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. ENABLE/ 
.DISABLE (Cont.) 


-ERASE SYMBOL 


-IF ENABLED/ 
DISABLED 


SUMMARY OF TECHNICAL CHANGES 


TIMEOUT Enabled: Indirect uses the timeout 
Parameters specified for the .ASKx 
directives. 

TRACE Disabled: commands processed by 
Indirect are not displayed on the 
terminal. 


TRUNCATE Disabled: truncate errors on a 
»-READ directive are not ignored. 


The GLOBAL option is now enabled by default. 
Deletes a symbol from the global symbol table. 


Tests the .ENABLE/.DISABLE options. 


-OPENR 
- PARSE 


- READ 


.SETD/.SETO 


.SETL 


- TEST 
- TESTDEVICE 


- TESTFILE 


- TESTPARTITION 


Opens a file for reading with the .READ command. 
Parses strings into substrings. 


Reads a record from a file into a specified string 
variable. 


Redefines the radix of a numeric symbol. 


Defines or redefines a logical symbol and assigns 
the symbol a true or false value. 


Now also locates a substring. 

Returns information about a device in the system. 
Determines if a specified file exists and 
determines the physical device associated with a 


logical name. 


Returns information about a partition in the 
system. 


The following are new or revised symbols: 


<ALTMOD> 


<BASLIN> 
<CONFIG> 
<EOF> 


<ERRCTL> 


Tests whether the last question was answered with 
an ALTmode or an ESCape. Synonymous with 
<ESCAPE>. 


Tests if the current operating system is a 
baseline configuration. 


Contains the parameter defaults specified when the 
current Indirect task was built. 


Tests whether the last .ASKx or .READ directive 
resulted in reading past the end of the file. 


Controls Indirect processing upon encountering an 
error. 
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<ERRNUM> 


<ERROR> 


<ERRSEV> 


<ERSEEN> 


<EXSTRI> 


<FPALSE> 


<FILATR> 


<FILERR> 


SUMMARY OF TECHNICAL CHANGES 


Contains the class number of an error that 
Indirect has finished processing. 


One of five symbols that define the exit status of 
an executed CLI-specific command line. The,other 
symbols are <SEVERE>, <SUCCES>, <WARNIN>, and 
<NOSTAT>. These symbols are associated with the 
numeric codes for <EXSTAT>. 


Contains the error severity mask associated with 
the error that Indirect has finished processing. 


Tests the error code of a file, the exit status of 
an executed CLI-specific command line, if <EOF> is 
true, the value for <ERRNUM>, or if the .SETT 
directive was used. 


Contains build-time information about the Indirect 
task or the string results from a more deeply 
nested indirect command file. The results are 
sent to the calling indirect command file. 


Logical constant used for comparisons with the .IF 
directive or as a default for the .ASK directive. 


Returns the seven words of file attribute 
information contained in the FCS-1ll File 
Descriptor Block (FDB). 


Contains the FCS-1l or I/0O driver status code 
resulting from a .TESTFILE, .OPENx, or .READ 
directive operation. 


<FILSPC> 


<FMASK> 


<FORATT> 


<IAS> 


<LOCAL> 


<LOGDEV> 


<LOGUIC> 


<NETUIC> 


Contains the fully qualified specification for a 
file referred to with the last .OPENx or .TESFILE 
directive operation or in the last specification 
for a nested command file. 


Contains octal values that represent answers to 
some of the system generation questions. 


Contains the octal value of the file attributes 
used to open the data files. 


Tests whether the current system is IAS. 
Synonymous with <RSX-11D>. 


Tests whether the terminal from which Indirect is 
running is a local terminal. 


Contains the device name and unit number of the 
user's login account or SY0O:. 


Contains the login UIC of the current user or the 
current default UIC. 


Contains the UIC in which DECnet-related tasks are 
stored. 
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<NETNOD> 


<NOSTAT> 


<NUMBER> 


<OCTAL> 


<PRIVIL> 


<SEVERE> 


<SUCCES> 


<SYMTYP> 


<SYSDEV> 


<SYSID> 


<TICLPP> 


<TICWID> 


<TIMOUT> 


<TISPED> 


<TITYPE> 


<TRUE> 


<WARNIND>D 


SUMMARY OF TECHNICAL CHANGES 
Contains the DECnet node name for the system or 


One of five symbols that define the exit status of 
an executed CLI-specific command line. 


Tests whether the last string entered in response 
to an .ASKS directive or tésted with a .TEST 
directive contains only numeric characters. 


Tests whether a value used in a .ASKN or .TEST 
directive operation is octal. 


Tests whether the current user is privileged. 


One of five symbols that define the exit status of 
an executed CLI-specific command line. 


One of five symbols that define the exit status of 
an executed CLI-specific command line. 


Contains the numeric code for the type of symbol 
tested with a .TEST directive. 


Contains the physical device name of the boot 
device for the system. 


Contains the base-level number for the system. 


Contains the current page length setting for the 
terminal. 


Contains the current page width setting for the 
terminal. 


Tests whether the last .ASK directive timed out 
waiting for a user response. 


Contains the baud rate for host-to-terminal 
character transmission. 


Contains the terminal type of the terminal from 
which Indirect is running. 


Logical constant used for comparisons with the .IF 
directive or as a default for the .ASK directive. 


One of five symbols that define the exit status of 
an executed CLI-specific command line. 


The following are new switches: 


/{(NO]CLI 


/LB 


(/CLI default) Passes commands not processed by 
Indirect to the default command line interpreter 
(CLI) for the terminal. Synonymous with /[NO]MC. 


Indicates that the specified file is a universal 


library of command procedures and that’ the 
specified module is the procedure to be executed. 
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SUMMARY OF TECHNICAL CHANGES 


/LO (/NOLO default) Indicates that when a new file is 
executing, it can have access to the local symbols 
created by its calling command file, and that any 
local symbols created by the new command file will 
be defined as local symbols for the calling 
command file. 


The following is new functionality in Indirect: 
Parameter passing 
Parameters for a command file can now be passed to Indirect for 
processing. The parameters are stored in the reserved local 
symbols PO, Pl, P2, P3, P4, P5, P6, P7, P8, P9, and COMMAN. 
Universal library support 
When command procedures, which are indirect command files, are 
inserted into a universal library with the Librarian Utility 
Program (LBR), they can then be referenced with the new 
/LB:module switch. 
Command libraries are built by creating a universal library and 
inserting command files into it. The procedures in the library 
can then be referenced in the form @command-library/LB:module. 
Substitution format control 
Format control is available for numeric values being converted to 


string values and for string and logical values being placed ina 
substitution operation. 
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CHAPTER 1 


INTRODUCTION TO MCR 


The Monitor Console Routine (MCR) serves as an interface between you 
and the RSX-11M/M-PLUS system. You issue MCR commands from a 
terminal. 


Before trying to use MCR commands, be sure that your terminal is’ set 
to MCR, You can verify this by pressing CTRL/C and getting the 
explicit MCR prompt (see Section 1.1.1). If you would like MCR to be 
the default command line interpreter for your terminal, have your 
system manager set this up for you in the account file. 


1.1 MCR COMMAND LINES 


To issue an MCR command, type a command line in response to a default 
(>) or explicit MCR (MCR>) prompt. A command line consists of three 
components: a command name, any required parameters, and a line 
terminator. 


It is not necessary to type the entire command name when submitting a 
command. MCR requires only the 3-letter abbreviation for a command 
name, except for HELP, which must be entered in full. The command 
name is then followed by the command parameters. 


For example, you can type the CANCEL command as follows: 
>CAN taskname RE) 


The variable taskname is a parameter for the CANCEL command and RET 
Signifies the RETURN key, the line terminator. As in this example, 
the command you use often consists of the first three letters of the 
command name. Some commands, however, have 3-letter acronyms as 
command names. For instance, the names for the ASSIGN and USER FILE 
DIRECTORY commands are ASN and UFD, respectively. 


With most of the commands, you can specify a longer form of the 
command name. This is unnecessary, however, because MCR only uses the 
required three letters, but to make the intent of the command clear to 
someone reading a printed copy of command input, you can type: 


>CANCEL taskname ED) 
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A space or a tab signals the end of the command name; therefore, no 
spaces or tabs are allowed within the command name itself. For 
example, 


>OPENREGISTER address 
is permissible, while 

>OPEN REGISTER address 
is not. 


Typically, a command parameter is a task name, the name of a file, or 
a device specification. A parameter can be modified by a keyword 
(defined in Section 1.1.2). 


You press the RETURN key RET) or the ALTmode or ESCape key — -€SC 
to terminate a command line. MCR returns the default prompt after 
processing a command line terminated by pressing the RETURN key. MCR 
Suppresses the default prompt after processing a command line 
terminated by the ESCape key, except when the ESCape key has_ special 
Significance as a terminator (with the RUN and OPENREGISTER commands, 
for example). MCR accepts subsequent unsolicited input even though 
the default prompt does not appear. 


When MCR parses a command line, it normally compresses any multiple 
Spaces and tabs and treats character strings beginning with a 
semicolon (;) or an exclamation mark (!) as comments (see Section 
gees bes ae 


When you use quotation marks ("") in the command line, however, MCR 
parses that part of the line within the quotes exactly as you typed 
it. No compression occurs. This allows you to use special characters 
in your command line and to use American National Standard (ANSI) 
X.327-1978 file specifications, which can have embedded spaces. 


If you use only one quotation mark in the command line, MCR assumes an 
ANSI file specification and does not compress the line past the 
quotation mark. (See the RSX-11M/M-PLUS I/0 Operations Reference 
Manual for more information on Support for quotation marks.) 
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1.1.1 The MCR Prompt 


When you use MCR, there are three prompts that indicate a terminal is 
waiting for input from you: the default prompt, task prompts, and the 
explicit MCR prompt. The default prompt and task prompts are 
described more fully in Chapter 2. 


A terminal always sends to MCR any input typed in response to the 
explicit MCR prompt (MCR>): 


MCR>command-input 


You invoke the explicit MCR prompt by pressing the CONTROL (CTRL) key 
and the C key Simuitaneousiy. 


However, CTRL/C does not invoke the MCR prompt in a special case as 
described in the second item in the following list. The description 
of CTRL/C in Table 2-2 also describes two other situations in which 
CTRL/C does not invoke the explicit MCR prompt. 


The following notes explain various uses of the explicit MCR prompt: 


1. When a terminal is displaying the default prompt (>), there 
is no guarantee that input typed in response to the prompt 
will be directed to MCR because another task may have 
attached to the terminal. To ensure that MCR does receive 
the input, press CTRL/C to invoke the MCR prompt. After MCR 
processes the command line, the terminal will display the 
default prompt. . 


2. When a terminal is displaying a task prompt (tsk>), you can 
invoke MCR by pressing CTRL/C. After (or while) MCR 
processes the command line, the terminal will display the 
original task prompt. 


If you requested MCR to display information (with the TIME 
command, for example) and it is not displayed before the task 
prompt appears, press the RETURN key. This will display the 
information and then the original task prompt. Also press 
the RETURN key if you would like to know if MCR processed the 
command line or if it returned an error message. 


NOTE 
If an attached task specifies an 
Asynchronous System Trap (AST) upon 
receiving unsolicited input, CTRL/C 


causes an AST to occur, thereby gaining 
the task's attention rather than MCR's. 
Consequently, the MCR- prompt does not 
appear. 


3. When any terminal is receiving output from a task, you can 
interrupt the output by pressing CTRL/C. At the completion 
of the current I/O operation, the terminal displays’ the 
explicit MCR prompt. After MCR processes the command line 
directed to it, the system resumes the interrupted output. 
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In all three cases, if the command line invokes a task, the task will 
issue its own prompt. You can respond to this prompt with another 
CTRL/C, which invokes the MCR prompt. You can then request another 
task that issues its own prompt and so on. (Note that because CTRL/C 
does not abort the task that was active when you typed the CTRL/C, it 
is possible to have several tasks active at your’ terminal 
concurrently.) 


1.1.2 Keywords 


Some of the MCR commands use keywords that affect a command parameter. 
Keywords are similar in function to switches (described in Section 
2.2). A keyword consists of a slash (/), followed by an alphanumeric 
name, and optionally followed by an equal sign (=) and the value for 
the keyword, as follows: 


/kKeyword=value 


A keyword modifies the action of a command. You can apply aé_é keyword 
directly to the command or to a command parameter, depending on the 
command. If the keyword follows the command name, it modifies the 
action of the command. If the keyword follows a parameter, it 
modifies the action for the parameter. 


For example, the INSTALL command requires a file name parameter’ that 
specifies the task to be installed. You can append keywords to this 
file name. One such keyword, /TASK, specifies the name under which 
the task is to be installed. For example: 


>INS BOB. TSK/TASK=AMBER 


This command installs the task image file BOB.TSK with the name AMBER. 
When you want to use the task, you invoke it with the name AMBER. 


You can enter keywords in any order. They are command-specific and 
are defined in the descriptions of the commands (Chapter 3). 


1.1.3 Comments 


MCR treats a line of text as a comment if the first character in the 
line is a semicolon (;). In addition, you can use the exclamation 
point (!) to delimit comments within a command. The first exclamation 
point starts the comment and the next exclamation point or line 
terminator ends the comment. MCR ignores all text between the _ two 
exclamation points. For example: 


>; THIS LINE IS A COMMENT 
>TAL !THIS IS A COMMENT STRING! RMDEMO 


Comments are especially useful to clarify commands in indirect command 
files, which are described in Chapter 4, 


To use the semicolon and exclamation point characters in the command 
line, use quotation marks (see Section 1.1). 
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1.2 THE MCR INTERFACE 


MCR parses the input you type to determine what the command line is 
requesting and then responds appropriately to the input. To service a 
“request, MCR either uses an MCR overlay or activates an independent 
task, 


By following the procedures outlined in the following text, MCR 
activates the appropriate overlay or task to service each command. 


The required three letters of the command name are _ the most 
significant part of a command line. MCR uses the name to determine 
the necessary overlay or task as follows: 


1. MCR searches a table containing names of commands serviced by 
MCR itself. If the table contains a matching command, MCR 
either loads the corresponding overlay or starts the 
secondary task (...MCR), which invokes the correct overlay. 
The overlay then proceeds to process the command line. (On 
single-user RSX-11M systems, all commands are serviced by 
MCR..., the primary MCR task. There is no secondary MCR 
task.) 


2. If the table does not contain a matching command, MCR 
prefixes three dots (...) to the command name and then 
searches the System Task Directory (STD) for a task by that 
name (that is, ...tsk). MCR returns an error if the STD does 
not contain the specified task. 


1.3 MCR COMMAND SUMMARY 


The MCR commands described in Chapter 3 are listed here by category. 
This command summary provides a compact overview of the facilities 
available at your terminal. Commands followed by (NP) are available 
to all users. Commands followed by (P) are available only to 
privileged users. Commands followed by (NP,P) are nonprivileged 
commands with privileged options. Commands followed by (P,NP) are 
privileged commands with nonprivilieged options. 


Initialization Commands 


ACS (P) 


ASN (NP,P) 


BOOT (P) 


DMOUNT (NP, P) 


FLAGS (NP,P) 


HOME (NP,P) 


INITVOLUME (NP) 


INSTALL (P) 


LOAD (P) 


MOUNT (NP,P) 


REDIRECT (P) 


SET (NP,P) 


TIME (NP,P) 


UFD (NP,P) 


Informational Commands 


ACT (NP) 


CLQUEUE (NP) 


DEVICES (NP) 


LUNS (NP) 


INTRODUCTION TO MCR 


Allocate or discontinue’ the use of a 
checkpoint file on disk. 


Define or delete a logical device assignment. 
Display current assignments on your terminal. 


Bootstrap a new system into memory and 
transfer control to it. 


Dismount a volume by marking the volume for 
dismount and releasing its control blocks 
(complement of MOUNT). 


Create, display, or eliminate group global 
event flags. 


Alter the values contained in various fields 
of the home block of a Files-11l disk volume. 


Initialize a disk, DECtape, or magnetic tape 
to produce a Files-11 volume. 


Install a task in the system. 

Load a nonresident device driver into memory. 
Mount a volume by creating its control blocks 
and declaring the volume on-line for access 


by the file system. 


Redirect all I/O requests from one physical 
device to another. 


Alter or display system, device, or task 
characteristics. 


Enter the time and date into the system. 
Display the time and date on your terminal. 


Create a USer File Directory (UFD) in a 
Master File Directory (MFD) ona Files-1ll 
volume. 


Display on your terminal the names of active 
tasks that were requested from that terminal. 


Display on your 
information for 


Display on your terminal information about 
tasks in the clock queue. 


Display on your terminal information about 
peripheral devices recognized by the system. 
Display on your terminal the list of sta 
logical unit number (LUN) assignments fo 
specific task. 
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PARTITIONS (NP) 


TAL (NP) 


TASKLIST (NP) 


Task Control Commands 
ABORT (NP,P) 
ALTER (P) 

BLOCK (NP,P) 


CANCEL (NP,P) 
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Display on your terminal a description of 
each partition in memory. 

Display on your terminal the names and status 
of all tasks in the system or the name and 


status of a specific task. 


Display on your terminal a description of 
each installed task. 


Terminate execution of a running task. 
Alter the priority of a task. 
Block a task. 


Cancel time-based initiation requests for a 
task (no effect on current execution). 


FIX (P) 


REASSIGN (P) 


REMOVE (P) 


RESUME (NP,P) 


RUN (NP,P) 


UNBLK (NP,P) 


UNFIX (P) 


UNLOAD (P) 


UNSTOP (NP,P) 


Fix a task in a partition in memory (the task 
becomes memory-resident). 


Change logical unit number (LUN) assignments 
for a task. 


Remove a task from the system (complement of 
INSTALL). 


Resume execution of a suspended task. 


Initiate the execution of a task. The task 
may run immediately, after a time delay, or 
in synchronization with the system clock. 
Periodic rescheduling is optional. 


Unblock a previously blocked task (complement 
of BLOCK). 


Make a memory-resident task nonresident 
(complement of FIX). 


Remove a loadable device driver from memory 
(complement of LOAD). 


Resume execution of an internally stopped 
task. 


System Maintenance Commands 


BRK (P) 


OPEN (P) 


SAVE (P) 


Pass control to the Executive Debugging Tool 
(XDT). Valid only for systems that have 
generated XDT support. 


Display on the entering terminal the contents 
of a memory location for examination or 
modification. 


Copy the current system image into the system 
image file from which the system was booted. 


SSM (P) 
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Insert text into the error log file. 


Multiuser Protection Commands 


ALLOCATE (NP,P) 
BRO (NP,P) 


BYE (NP) 
DEALLOCATE (NP,P) 
HELLO or 
LOGIN (NP) 
HELP (NP) 
Command Line Interpreter 


CLI (P,NP) 


DCL (NP) 


Allocate a device to a user (establishes the 
device as the user's private device). 


Broadcast a message to one terminal or to a 
set of terminals. 


Log out of the system. 


Deallocate a private (allocated) device 
(complement of ALLOCATE). 


Log in on the system. 


Display the contents of a help file. 
Commands 


Work with a command line interpreter (CLI) 
other than MCR. 


Issue a DIGITAL Command Language (DCL) 
command from a terminal set to MCR. 


CHAPTER 2 


SYSTEM CONVENTIONS 


This chapter discusses basic concepts of the RSX-11M/M-PLUS Files-11 
file system and highlights aspects of file handling that directly 
relate to user functions. The chapter also discusses devices, 
terminals, and tasks. The last section discusses briefly the Account 
File Maintenance Program (ACNT). 


2-1 FILES-11 


RSX-11M/M-PLUS includes a software system called Files-11 to oversee 
the storage and handling of files. In RSX-11M/M-PLUS, a file is an 
owner-named area on a volume, and volumes are magnetic media such as 
disks, DECtape, and magnetic tapes. Two RSX-11M/M-PLUS utilities and 
three MCR commands help you to prepare volumes for use with Files-ll: 


e Disk Volume Formatter Utility (FMT) 
e Bad Block Locator Utility (BAD) 

e INITIALIZE VOLUME (INT) 

e MOUNT (MOU) 

e USER FILE DIRECTORY (UFD) 


The utilities are described in the RSX-11M/M-PLUS Utilities Manual. 
The commands are described in Chapter 3 of this manual. 


Files-11 supports three types of specially formatted volumes: disks, 
DECtapes, and magnetic tapes. (Files-11l magnetic tapes conform to the 
American National Standard X3.27-1978.) 


For a volume to become a Files-11 volume, you must initialize it with 
the INI command. A volume that has not been initialized by INI is a 
"foreign" volume. On RSX-11M, foreign volumes do not have to be 
mounted for you to work with them (although it is wiser to mount them 
for protection purposes); on RSX-11M-PLUS, the volumes must be 
mounted as foreign (MOUNT /FOR). 


A system utility called the File Transfer Utility Program (FLX) allows 
you to access foreign volumes in DIGITAL's DOS-11 or RT-11 format. 
FLX translates files on such volumes into Files-11 format. In most 
cases, a DECtape will have a foreign format and therefore require the 
use of the FLX utility. See the RSX-11M/M-PLUS Utilities Manual for a 
full description of FLX. 


Before Files-ii can access a file, the volume that contains the _ fiie 
must be known to the system. You make a Files-11 volume known to the 
system by issuing the MOUNT command for the device on which the volume 
is loaded. 
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2.1.1 File Ownership and Directories 


When you create a file, the system places the file name in a User File 
Directory (UFD) and stores your current User Identification Code (UIC; 
see Section 2.2.1) in the file header to indicate that you are _ the 
owner of the file. In most cases, the UFD corresponds to your UIC, 
but a file can be listed in a UFD that is not related to your UIC. It 
is also possible for your file to be listed simultaneously in more 
than one UFD. (The files will have different file-IDs.) 


Each user has a default UFD corresponding to his or her UIC. The UFD 
is ona default system device (SY:), which is specified by the system 
manager when the user's account is created. 


A UFD is itself a file, which you must explicitly create by means of 
the MCR UFD command (see Chapter 3). You specify a UFD in the format 
[g,m] where g and m are octal numbers in the range 1 through 377 (0 is 
reserved). The numbers’ represent the file owner's group and member 
number, respectively. The actual name of the UFD is a concatenation 
of the group and member numbers, terminated by .DIR. For example, the 
name of the directory that corresponds to the UFD [203,65] is 
203065.DIR. (Note that leading zeroes are added to the UFD to make g 
and m three digits each.) 


All UFDs oh a volume are listed in the volume's Master File Directory 
(MFD) , which corresponds to UFD [0,0] and is therefore named 
OO00000.DIR. The directories (the UFDs and the MFD) list the names of 
files and contain pointers to each file's header. The file header 
contains information about the file's owner and the physical location 
of the file segments; the header occupies one or more blocks of the 
volume's index file ([0,0]INDEXF.SyYS). 


To delete a UFD, you can use the Peripheral Interchange Program (PIP) 
to first delete all of the files contained in the UFD (thereby freeing 
the space for future use) by typing: 


PIP>[g,m]*.*;*/DE 
After you delete all the files, use PIP to delete the UFD by typing: 
PIP>{0,0]gggmmm.DIR;*/DE 


The variable gggmmm is the concatenation of the group and member 
number components of the appropriate UFD. 


Refer to the RSX-11M/M-PLUS Utilities Manual for a detailed 
description of PIP. 


To access a file, you must know the UFD in which it is’ listed. This 
knowledge, however, is not sufficient to guarantee access. You must 
also satisfy conditions specified in a protection mask associated with 
the file you wish to access. The volume that contains the file must 
be mounted before the file system can access the file. 
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Every file has a protection mask that describes the types of access 
allowed to each of four user groups. RSX-11M/M-PLUS allows four types 
of access: 


Read The user, or the user's task, may read, copy, print, or 
type the file, and, if it is a task, run it. 


Write The user, or the user's task, may add new data to the 
file by writing to space already allocated to the file. 


Extend The user, or the user's task, may change the amount of 
disk space allocated to the file. 


Delete The user, or the user's task, may delete the file. 
The four user groups are defined by UIC: 


System The operating system itself and privileged users (those 
having group numbers of 10 octal or less). 


Owner The user having the same UIC as the one the file was 
created under. 


Group All users having the same group number as the one the 
file was created under. 


World All users. 
A file owner assigns access rights by one of the following means: 


INI This command allows you to specify default file 
protection for all files subsequently created on the 
initialized volume. 


UFD This command establishes access rights to a UFD file 
only. A user often allows read access to a UFD but 
denies write, extend, or delete access to the files 
listed within it. 


MOUNT This command allows you, while mounting a volume, to 
specify the default file protection to be given to files 
created on the volume. This protection overrides the 
protection established with the INI command. 


PIP This utility has an option that enables the owner to 
alter access rights to files. 


TO gain access to a file, a user must satisfy the protection mask of 
both the file to be accessed and the UFD in which the file is listed. 
For example, to write to an existing file, you need at least’ read 
access to the UFD and write access to the file. To create a new file, 
you need both write and extend access to the UFD. 


2.2 FILE SPECIFICATIONS 

MCR uses a standard format for referring to files in a command line. 
The format is a string consisting of one or more input and output file 
specifications, as follows: 


outfilel...,outfilen=infilel...,infilen 
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The variable outfile is an output file specification and infile is an 
input file specification. The dots (...) indicate that you may 
include any number of file specifications in the string, the number 
being determined by the receiving command or task. The command line 
(the line of file specification task or command name) cannot 
exceed 80 characters (or, f plex terminals, the maximum 
buffer size set for your terminal) 


Some commands and tasks may not require the outfile portion. When it 
is omitted, you might also be able to omit the equal sign (=). 


The individual file specifications (whether input or output) have’ the 
following format: 


ddnn: [g,m] filename.type;version/switchl.../switchn 


ddnn: 


Specifies the physical or logical device unit on which the volume 
containing the file resides. The device unit is expressed as a 
2-character alphabetic device name and an optional 1l-, 2-, or 
3-digit octal unit number, followed by a colon (for example, 
TT104: or LP1l:). If you do not specify a unit number, it 
defaults to 0. The default device is your system device (SY:). 


[g,m] 


Specifies the User File Directory (UFD) in which the file is 
listed. The variables g and m are octal numbers from 0 through 
377 that represent the file owner's group and member number, 
respectively. The square brackets are a mandatory part of the 
UFD syntax. The default is the current User Identification Code 
(UIC; see Section 2.2.1) to which your terminal is set. 


filename 


Specifies the name of the file, an alphanumeric string from 0 
through 9 characters in length (however, there are exceptions to 
this, depending on what program you are working with). A _ period 
alwayS separates the file name from the file type. You must 
specify the file name. No default is applied. 


If you want to include special characters in the file name (for 
example, semicolons or exclamation marks), place quotation marks 
around the name so that MCR will parse the name exactly as you 
typed it. If you use only one double quotation mark, MCR assumes 
an ANSI magnetic tape file name and parses the. name as_ such. 
(See Section 1.1 for more information on using quotation marks.) 


type 


Consists of a 1l- through 3-character alphanumeric mnemonic that 
identifies the nature of the file's contents, or it can be null. 
For example, .FTN indicates that the file contains a FORTRAN 
source program and .OBJ indicates that the contents are object 
(compiled) code. Some conventional and default RSX-11M/M-PLUS 
file types are listed in Section 2.2.4. A semicolon (;) always 
separates the file type from the version number. 
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version 


Consists of an octal number from 1 through Pat A ae ae | that 
distinguishes various versions of a file. For example, when a 
file is created, the system assigns it a version number of 1 by 
default. Thereafter, each time the file is opened and, unless 
you specify otherwise, the file system creates a new file with 
the same file name and file type, but with a version number 
incremented by one. Note that if a file has a version number of 
77777, no more versions of it can be created. 


The numbers -1l and 0 have special significance: -1 implies the 
lowest existing version of a file and 0 implies the highest 


* 3 
existing version. 


The default is the highest version of the file. 
/switch (or /keyword) 

Consists of an ASCII name that identifies a task or command 
option. Options generally modify the task's function in.some way 
or provide information that the task needs to respond correctly 
to the command line. 
The switch itself can be in one of three forms: 

/ SW Sets the switch action. 

/-SW Negates the switch action. 


/NOsw Negates the switch action. 


The number of values permitted and the interpretation of a switch 
depend on the task to which the switch is directed. 


You can also modify switches with arguments. These arguments may 
be ASCII strings, octal numbers, or decimal numbers. The 
following rules apply: 


e Numbers terminated by a decimal point (.) are decimal. 
e Numbers preceded by a pound sign (#) are octal. 


e Whether the default for a numeric value is octal or 
decimal depends on the command or task to which the 
Switch is directed and on the switch itself. 


@e You can precede any numeric value by a plus (+) or minus 
(-) sign; plus is the default. 


e A plus or minus sign, if present, must precede the pound 
Sign (#) of an explicit octal number (for example, 
~#323). 


2.2.1 User Identification Codes (UICs) 


On RSX-11M systems that do not “support — multiuser protection, each 
‘terminal has, at any. one time, one User Identification Code (UIC). OA 
‘terminal's associated UIC is determined by the last SET /UIC. command 
issued for. the terminal, or is [200, 200] if the terminal's UIC has not 
been. altered — since system generation. a ae 
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ing terminal whenever. you 
ion. | ‘The system also checks 


The system uses” ‘the ‘current 
omit the UIC. field of a 

this uIC against the protecti ‘S ry file: tS 
Soe Die check ‘Geters hts to the file (see. 


On multiuser protection systems, a terminal has two UICs: a 
protection UIC and a default UIC. The system checks the protection 
UIC against a file's protection mask to determine a user's access 
rights to the file. The default UIC determines the UFD of the file to 
be accessed whenever you omit the UIC field in the file specification. 
(See Section 2.1.1 for more information on UFDs.) 


How the system sets these two UICS depends on the privilege status of 
the user logged in at the terminal. When a nonprivileged user logs 
in, the terminal assumes the user's login UIC as its protection UIC. 
The login UIC also becomes the initial default UIC for the terminal. 
You can issue the SET /UIC command to alter the default UIC, but the 
protection (login} UIC remains unchanged. 


When a privileged user logs in, the terminal also assumes the _ login 
UIC as the protection and default UICS. However, when you issue the 
SET /UIC command, the system alters both of these UICs instead of just 
the default UIC. Because the protection UIC is also changed, the 
system no longer knows your login UIC. (This does not apply to 
RSX-l1M-PLUS systems on which Resource Accounting is active because 
the accounting system keeps a record of every user's login UIC.) 


2.2.2 Wildcards 


Wildcards allow you to specify more than one file in a_ single 
specificaton by placing them in one or more fields of the 
specification. A wildcard causes the system to ignore the contents of 
the wild field and to select all the files that satisfy the remaining 
explicitly specified fields. 


Asterisk wildcards (*) can be used in any part of the file 
specification except the device-unit field, which must be explicitly 
supplied or defaulted to SY: (see Section 2.2.3). The following 
examples illustrate the advantage of using the asterisk wildcard: 


PIP>PROG.MAC;1,PROG.OBJ;1,PROG.TSK;1/DE 


This command line deletes the three individual files specified. 
(The /DE Switch instructs PIP to delete the files.) Since the 
three files have the same file name and version number, but 
different types, the following command line would delete the same 
files: 


PIP>PROG.*;1/DE 


This command line also deletes any other files (on the default 
device in the default UFD) named PROG with a version number of l. 
You should check existing files before using wildcards (for 
example, by issuing the command line PIP>PROG.*;1/LI). 
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2.2.3 File Specification Defaults 


You can omit any field in a command-line file specification except the 
me ta 1 ine a se ‘an ta * Bove ee oe é 
file name.+ When you omit one or more fields in a file specification, 
the system assumes the following defaults: 


Field Default 
ddnn: The pseudo device unit SY:.2 
{g,m] The default UIC (see Section 2.2.1) specified for 


each terminal in one of the following ways: 


1. At system generation (see the RSX-11M or 
RSX-1LiM-PLUS System Generation and 
Installation Guide) 


2. By means of the SET command (see Chapter 3) 


3. By means of the HELLO command (see Chapter 
3) 


filename No default (except for the BOOT command). A 
specification must include an explicit file name or a 
wildcard within the file-name field (see Section 
2e2a2) 


type Any l- through 3-character alphanumeric mnemonic, one 
of the types listed in Section 2.2.4, or null. 
Default types depend on the task to which the 
specification is directed and whether the 
specification refers to an input or an output file. 
For example, the FORTRAN compiler defaults the type 
of an input file to .FTN and the type of an output 
file to .OBJ. 


version For input files, the highest existing version number. 


For output files, the highest existing version number 
plus: a 


/switch Switch defaults are established by individual tasks 
and commands. 


2.2.4 Conventional and Default File Types 
RSX-lLIM/M-PLUS has a set of conventional and default file types used 


to reflect the contents of a file. (The defaults used by 
DIGITAL-supplied software are described in the manuals that pertain to 


1. The BOOT command is the only exception to this rule. 
See Chapter 3. 


2. The BOOT command and specification of a dollar sign ($) in the 
INSTALL and RUN command lines default to device LB:. See Chapter 3. 
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the individual programs.) Although you can assign your own 3-character 


file types, 
Type 
BAS 
BAT 
B2S 
CBL 
CLB 


CMD 


COR 


DAT 


DIR 


FTN 


LOG 
LST 
MAC 
MAP 
MLB 


OBJ 


ODL 
OLB 


PAT 


POB 


SML 


STB 


it is convenient to use the following types: 


File Contents 
BASIC-11 language source program (default) 
Batch file (default) 
BASIC-PLUS-2 source program (default) 
COBOL language source program (default) 
Indirect command file library (default) 


MCR or task commands (an indirect command file; 
default) 


SLP correction file (convention; must be specified) 


Data (as opposed to a program; convention; must be 
specified) 


Directory (for example, a User File Directory; 
default) 


FORTRAN IV, FORTRAN IV-PLUS, and FORTRAN-77 language 
source program (default) 


Log of batch processing session (default) 
Listing file (default) 

MACRO-11 source program (default) 

Task Builder memory allocation map (default) 
Macro library (default) 


Object program (output from the MACRO-11 assembler or 
a compiler; default) 


Task Builder overlay description (default) 
Object module library (default) 


Correction file used by assembler to create a patched 
object module (convention; must be specified) 


Patched object module input file used by the PAT 
utility (convention; must be specified) 


System macro library (default) 

Symbol table (default) 

Bootable system image (default) 

Temporary file (convention; must be specified) 
Task image (default) 

Text file (convention; must be specified) 


Universal library file (default) 
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2.2.5 Examples of File Specifications 


In the following examples, the three letters followed by a right-angle 
bracket (>) are standard task prompts for the respective system 
programs. 


e Assemble the MACRO-11 source file CRGPT.MAC and create the 
object output file CRGPT.OBJ. UFD [200,200] on device DMO: 
is specified for both files. 


MAC>DMO: [200,200] CRGPT. OBJ=DM0: [200,200] CRGPT.MAC 


e Delete the file SBG.OBJ;5. The output file specification is 
not applicable and therefore is omitted. The input device 
defauits to SY:. 


PIP>[200,200]SBG.0BJ;5/DE 


@ Task-build the object file CRGPT.OBJ (.OBJ is the default file 
type for object files). The output file will be named 
CRGPT.TSK because .TSK is the default file type for the Task 
Builder's output file. The device and UFD are also defaulted. 


TKB>CRGPT=CRGPT 


e Delete all files with the name TESTDAT, regardless of type or 
version. The system uses default values for the device and 
UFD. 


PIP>TESTDAT.*;*/DE 


2.3 DEVICES 


A primary function of the operating system is to manage all connected 
peripheral devices and thus maintain efficient system performance. 
Peripheral devices are the actual hardware elements that make up the 
computer system. During system generation, the system manager 
explicitly describes all peripheral devices attached to the system. 
Devices within multiuser protection systems are subject to a special 
set of MCR functions (described in Section 2.3.5). 


Each device has a unique identifier. The identifier consists of two 
alphabetic characters, which form a logical device name (see Section 
2.3.4), and an optional 1-, 2-, or 3-digit octal unit number, followed 
by a colon (:). If you omit the optional octal unit number, the 
system defaults to unit 0. 


See the RSX-11M or RSX-11M-PLUS System Generation and Installation 


Guide for a list of the peripheral devices supported by the respective 
operating system. 
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2.3.1 Logical Unit Numbers 


A task performs I/O operations using logical units identified by 
numbers, called logical unit numbers (LUNs), rather than using 
specific device units. You assign a LUN to a specific device before 
the task actively uses the LUN. You can make the LUN assignment at 
one of three points: 


1. At task-build time 


2. From within the task at run time using the ALUNS Executive 
directive 


3. With the REASSIGN command after the task has been installed 
and while it is dormant 


Refer to the RSX-11M/M-PLUS I/0 Drivers Reference Manual or _ the 
appropriate language user's guide for more information about logical 
unit numbers. 


2.3.2 Pseudo Devices 


A pseudo device is a device-unit name that usually corresponds to a 
real physical device. This association is declared through the 
commands ASSIGN and REDIRECT. Pseudo devices provide a_ shorthand 
method for referencing the physical devices (for example, the pseudo 
device name SY: refers to the user's system device). Table 2-1 lists 
some of the RSX-11M/M-PLUS pseudo devices. 


Table 2-1 
Pseudo Devices 


Pseudo Device Name | 


Console listing device 


Console output device 


System library device 


Terminal input/output device 


User's system device 


Spooling device (RSX-11M-PLUS only) 


In a given task, LUN 1 may be assigned to CL:, the console listing 
device. When the task references LUN 1, the data is sent to whatever 
device CL: has been redirected to. You can redirect CL: to any 
appropriate device (a line printer or a terminal, for example) without 
affecting the task's execution. 


A pseudo device redirected to a terminal assumes the privilege status 


of the terminal to which it is’ redirected. If the terminal is 
privileged, CL: becomes privileged when it is redirected to that 
terminal. But if CL: is subsequently redirected to a nonprivileged 


terminal, it will also become nonprivileged. 


SYSTEM CONVENTIONS 


The normal procedure is to redirect the console output device (CO:) to 
the main operator's terminal and CL: to the line printer. The system 
automatically redirects TI:, the most commonly used pseudo device, 
depending on how a task has been activated: 


@ When you issue the RUN command to activate a task immediately, 
the system redirects the TI: for that task to your terminal. 


e If, in a task, the Executive directives ROSTS or SPWNS 
activate another task, that task's TI: defaults to the TI: 
of the task that issued the directive. A privileged task can 
specify an alternate TI: for the activated task. 


e If the Executive enters a task into the clock queue _ for 
activation after a specified interval, the task's TI: 
defaults to CO:. (Both the RUN command and the Executive 
directive RUNS allow a task to be activated at a specified 
interval from the time the command or directive was issued.) 


2.3.3 The Null Device 


Program testing often requires an available input or output device. 
The null device (NL:) can be used for either of these purposes. NL: 
is neither a pseudo nor physical device, but, most of the time, it is 
considered to be a pseudo device. 


When a task reads from NL:, NL: returns the code for end-of-file 
(IE.EOF). When a task writes to -NL:, NL: returns the code for 
success (IS.SUC) but discards the output. 


As an example, if you are testing a program that normally generates 
large amounts of printout, you can assign the appropriate LUN to NL: 
rather than wasting paper or disk space. 


2.3.4 Logical Device Names 


Logical device names provide another means by which tasks can maintain 
device independence. (On RSX-11M, the availability of logical device 
names is a system generation option. On RSX-11M-PLUS, it is always 
included in the system.) A logical device name has the same syntax as 
a physical device unit. It consists of a 2-letter ASCII name and an 
optional 1- or 2-digit octal unit number, followed by a colon (:). 
The name can either be equivalent to a standard RSX-11M/M-PLUS device 
name (for example, DM:), or it can consist of two letters picked at 
random (for example, ZZ:). Before you run a task that refers to a 
logical device rather than a physical device, you must issue the 
ASSIGN command to associate the logical device name the task uses with 
a physical device unit (See Chapter 3). 


NOTE 


The names II: and RD: are used by 
DIGITAL software. Using these names as 
logical device names could produce 
undesirable results. 
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Three types of logical device assignments exist in RSX-11M/M-PLUS 
systems: global, local, and login. 


e Global assignments apply to all tasks running in the system. 


@ Local assignments apply only to tasks initiated from the 
terminal used to make the assignments. Any terminal can 
define or delete its own set of local assignments. 


e Login assignments apply only to systems that support multiuser 
protection. When a user issues the HELLO (or LOGIN) command 
to log in on the system, the system automatically establishes 
one or more login logical device assignments. The login 
assignments apply only to tasks initiated from the terminal 
while the current user is logged in. Only privileged users 
can define or delete login assignments. 


The system uses local assignments before it uses login and global 
assignments, and login assignments before global assignments. If you 
make a local assignment using a logical device name that is already 
used in a login assignment, the system uses the local assignment. 
When you delete the local assignment, the system goes back to using 
the login assignment. 


The Executive sets up a logical device table that records all logical 
device assignments and notes whether each assignment is local, login, 
or global. The Executive then searches this table every time a_ task 
refers to a device. A logical name found in the table receives 
precedence over a physical device unit having the same identifier. 


2.3.5 Public, Private, and Unowned Devices 


Systems that support multiuser protection impose special 
characteristics on devices. Devices can be public, private, or 
unowned. These characteristics are defined as follows: 


e A public device is a device that anyone logged into the system 
can use. A privileged user can make a device public by 
issuing the SET /PUB command. If a privileged user mounts a 
volume on a public device, all system users can access files 
on the volume without having to mount the volume themselves 
(depending on the volume and file protection specified for the 
volume). A public device cannot be allocated and can only be 
dismounted by a privileged user with the DISMOUNT /DEV 
command. (See Chapter 3 for descriptions of the MOUNT, 
DISMOUNT, and SET commands.) 


e A private device is a device that a user has allocated by 
means of the ALLOCATE command. Oniy privileged users and the 
owner of a private device - can access the device for use within 
the Files-1ll file system. If a nonprivileged user allocates a 
device and mounts a volume on the device, other nonprivileged 
userS cannot access the volume; privileged users can access 
the volume by issuing a MOUNT command. 


e An unowned device is a device that is neither public nor 
private. If a user, either privileged or nonpriviieged, 
mounts a volume on an unowned device, all other users’ can 
issue subSequent MOUNT commands and thus access the volume. 


Nonprivileged users can allocate and mount a volume on an 
unowned device. Privileged user so set public an 
unowned device. 
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A privileged user can designate any device in the system as a public 
device. The devices most commonly made public are the system disk (by 
Gefault) and the system library device. 

The ALLOCATE command (See Chapter 3) makeS an unowned device private 
to the user issuing the command. Allocating a device prevents any 
other nonprivileged user from accessing the device. (Privileged users 
can override a nonprivileged allocation.) When a user accesses a 
device without allocating it, other users can then access. and/or 
allocate that device. 


The DEALLOCATE command (see Chapter 3) changes a private device back 
to an unowned device, thereby allowing other users to gain access to 
it. Privileged users can deallocate any private device no matter who 
owns it. Nonprivileged users can deallocate only their own private 
devices. When a user logs out, the system automatically dismounts and 
deallocates any private devices belonging to that user. For efficient 
use of system resources, however, users should deallocate devices as 
soon as the devices are no longer needed. 


2.4 TERMINALS 


The terminal is the primary channel of communication between the user 
and the computer’ system. Each terminal ina system has a number 
associated with it, which is displayed when you log in. You can also 
refer to any terminal that you use as TI:, and you can work from more 
than one terminal at the same time. 


In RSX-11M/M-PLUS, several terminals can operate concurrently. Each 
terminal operates independently of others in the system so that each 
can run tasks at the same time. For example, the PIP utility and the 
MACRO-11 assembler can run concurrently from different terminals. 
(The same task can also run concurrently from different terminals, 
although each copy of the task running will have its own identifier. 
See Section 2.5.4 for more information.) 


2.4.1 Input Prompts 


When you use MCR, there are three prompts that indicate a terminal is 
waiting for input from you: 


e The default prompt (>) 
e The task prompt (tsk>) 


e The MCR prompt (MCR>) 
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The default prompt (>) at the beginning of a new line indicates’ that 
the terminal is ready to accept unsolicited input. The term 
unsolicited implies that no specific task has requested input from the 
terminal. Whatever you type in response to the default prompt is 
directed to MCR. (An abnormal situation can occur, however, if a task 
either solicits input or attaches to the terminal without displaying a 
task prompt. A soliciting or attached task might receive input’ that 
you intended for MCR. See Section 2.4.4 for information on attached 
terminals.) When MCR receives unSolicited input, it identifies, 
analyzes, and responds appropriately to the input. 


When MCR activates a task to service a command, the task normally 
prompts: 


tsk> 


The variable tsk is a 3-character task name. (All DIGITAL system 
tasks identify themselves by a 3-character prompt and user tasks 
should do the same.) 


As long aS a prompting task has attached to a terminal, the task 
receives all soltcited input entered at the terminal until the task 
detaches (see Section 2.4.4). The terminal discards all unsolicited 
input. An unattached task, however, may not receive solicited input 
because another task could solicit input from the terminal before you 
can type a response to the prompt for the unattached task. The 
intervening task would then receive the input intended for the 
unattached task. To avoid this situation, every task that solicits 
input from a terminal should perform the following sequence of 
actions: 


1. Attach to the terminal. 
2. Prompt with a properly formatted identifier (that is, tsk>). 
3. Solicit input (issue a read request). 


The MCR prompt (MCR>) is described in Section 1.1.1. 


2.4.2 Special Character Keys and Control Characters 


You can request the system to control terminal operation by means of 
special character keys and control characters. The relevant special 
character keys are TAB, ESCape (or ALTmode), RETURN, and DELETE (or 
RUBOUT). In this manual, the symbols (A , ESO , RT) , and @H , 
respectively, denote these keys. A control character is produced when 
you type a letter key while pressing the CTRL (control) key. In this 
manual, a control character is written CTRL/n where n is the variable 
letter key. 


When you type CTRL/R, CTRL/U, or CTRL/Z, the Executive and the 
terminal driver .display “R, “U, or “Z at the issuing terminal and 
perform the related function. When you type CTRL/C, the explicit MCR 
prompt (MCR>) is displayed. (If the terminal is set to recognize 
commands from DCL or a uSer-written CLI, CTRL/C would display that 
prompt instead.) For the other control characters, the Executive does 
not return a display. 


Table 2-2 lists all the special character keys and control characters, 
and describes the function of each. 
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Table 2-2 
Special Character Keys and Control Characters 


A CURR 


Description 


| character | 


RETURN 


The RETURN key terminates a line of input and advances 
the cursor or print head to the beginning of the next 
line. 


The ESC key terminates a line of input without moving 
the cursor or print head. When used to terminate an 
MCR command, it suppresses the default MCR_ prompt. 
See the descriptions of the OPEN and RUN commands (in 
Chapter 3), which have special uses for the ESC key. 


In systems that selected the appropriate optional 
facility at system generation, the ESC key can be the 
first character in an escape sequence (see the 
RSX-11M/M-PLUS I/O Drivers Reference Manual and the 
description of the SET /ESCSEQ command in Chapter 3 of 
this manual). 


DELETE The DELETE key deletes the last character typed at the 
terminal and further contiguous characters if the key 
is pressed repeatedly. On non-CRT terminals, the 
first DELETE typed deletes a character and prints a 
backslash (\) followed by a display of the deleted 
character. Subsequent deletions cause the system to 
display the deleted characters. Then, when you’ enter 
the first non-DELETE character, the system prints a 
terminating backslash followed by the character typed. 


For example: 


| 
first DELETE 
second DELETE 
third DELETE 
| p—fiest non-DELETE 


MISTKAE\ EAK\AKE 
The result is MISTAKE. 


On a CRT terminal that supports backspacing (a system 
generation option in RSX-11M; always included in 
RSX-11M-PLUS) and haS been declared to be a CRT 
terminal by the SET /CRT=ttnn: command, the DELETE 
key moves the printing position one space to the left 
and erases any character displayed in that position. 


For example, to correct the word MISTKAE, press’ the 
DELETE key three times to erase E, A and kK 
respectively. The result is MIST. Then type AKE_ to 
get MISTAKE. 


(Note that when DELETE deletes a character in the last 
character position on the right of the screen, the 
last character appears to remain and the next-to-last 
character disappears. However, the system has in fact 
deleted the last character. You can type CTRL/R_ to 


| verify this.) 


(continued on next page) 
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Table 2-2 (Cont.) 


Special Character Keys and Control Characters 


| character | Desertption 


CTRL/C 


CTRL/TI 


or 
TAB 
CTRL/K 


CTRL/L 


CTRL/O 


ee ene tee EN sen 


CTRL/C typed either as the first character in the line 
or when the terminal is sending data causes MCR to 
prompt for command input with the explicit prompt 
MCR>. If the terminal is set to a CLI other than MCR, 
typing CTRL/C displays the explicit prompt for the 
CLI. (Two special effects of CTRL/C are described in 
the following text.) 


If a task is prompting for input when you type CTRL/C, 
MCR displays its explicit prompt, then returns control 
to the interrupted task after receiving a single line 
of input. (An exception arises when an attached task 
specifies an Asynchronous System Trap -- AST -- for 
unrequested characters. In this case, CTRL/C causes 
an AST to occur, thereby gaining the task's attention 
rather than MCR's.) 


Special effects: 


e If the last character entered at the terminal 
was CTRL/S, CTRL/C resumes output Suspended by 
the CTRL/S. 


e If a terminal has been set to “hold screen" 
mode by the SET /HOLD command, CTRL/C has the 
effect of a SET /NOHOLD command; that is, 
CTRL/C disables hold screen mode. (The hold 
screen feature is, in some cases, a_ system 
generation option in RSX-11M but is always 
included in RSX-11M-PLUS.) 


See Section 1.1.1 for more information on using 
CTRL/C. 


CTRL/I (or TAB) moves the curSor or print head _ to 
the next horizontal tab stop on the line. The system 
establishes tab stops at every eighth character 
position in the line (8, 16, 24, and So on). 


CTRL/K causes a vertical tab by performing four line 
feeds. 


CTRL/L cause 
paging). The 
line feeds. 


a form feed (but does not pe 
action appears on the terminal as 


CTRL/O alternately suppresses and resumes the display 
of output at your terminal. It allows you to skip 
over any unwanted output and then continue the display 
at a later point. 


eRe eNO EN hie eR pitas eR eC Se a a as ee EE 


(continued on next page) 
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Table 2-2 (Cont.) 
Special Character Keys and Control Characters 


CTRL/O 
(Cont.) 


When you type the first CTRL/O, the system discards 
the output it is sending to your terminal rather than 
displaying it. (The system can send the output much 
faster when it does not also have to display it.) When 
you type the second CTRL/O, the system begins 
displaying the output at the point it has reached in 
sending it (not from where you typed the first 
CTRL/O). If you do not type another CTRL/O, the 
system continues to display the output until it 
reaches the end. The effect of CTRL/O also depends on 
the state of the terminal when you type the character. 
If the terminal is attached to a task other than MCR, 
CTRL/O suppresses the display of the task's output 
until you type another CTRL/O to resume the display 
(as described previously). However, if the terminal 
is not attached to another task, CTRL/O suppresses 
only the remainder of the line currently being 
displayed. Subsequent lines of output will still be 
displayed. 


CTRL/Q CTRL/Q typed after a CTRL/S resumes output suspended 
by the previous CTRL/S.. (This feature is a system 
generation option in RSX-11M but is always included in 
RSX-11M-PLUS.) 


CTRL/R Typing CTRL/R before typing a line terminator (RETURN 
or ESC) causes the system to retype the current line 
on a new line, omitting any deleted characters. You 
can then continue typing the remainder of the line. 


For example: 


MISTKAE\EAK\AKE “R 
MISTAKE 


If the current line is empty and you issue CTRL/R from 
the explicit MCR prompt (MCR>), CTRL/R performs a 
carriage return and line feed. CTRL/R is echoed as 
“R. (This feature is a system generation option in 
RSX-11M but is always included in RSX-11M-PLUS.) 


CTRL/S Typing CTRL/S while the terminal is receiving output 
suspends additional output until you type CTRL/Q or 
CTRL/C. The suspended output is merely delayed, not 
discarded as with CTRL/O. The combined functions of 
CTRL/Q and CTRL/S are convenient when using a CRT 
terminal. (This feature is a system generation option 
in RSX-11M but is always included in RSX-11M-PLUS.) 


CTRL/U Typing CTRL/U before typing a line terminator (RETURN 
or ESC) deletes the current line. The system responds 
with a carriage return and line feed and displays a 
new prompt so that the line can be retyped. 


(continued on next page) 
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Table 2-2 (Cont.) 
Special Character Keys and Control Characters 


CTRL/U The system also displays a CTRL/U when you begin to 

(Cont.) type a command line but do not press the RETURN key 
before the timeout count expires. (The timeout count 
is specified at system-generation time.) Again, a new 
prompt is displayed. 


CTRL/U is echoed aS “U. (This control character works 
only with the full-duplex terminal driver.) 


CTRL/X Typing CTRL/X clears the terminal typeahead buffer. 
The typeahead buffer temporarily stores input 
characters until the terminal driver can pass them to 
the task. When the typeahead buffer is full, input 
characters are not accepted. Typing CTRL/X clears the 
buffer. (This control character works only with the 
full-duplex terminal driver.) 


CTRL/Z Typing CTRL/Z indicates end-of-file. It is used _ to 
indicate to system tasks such as MAC, PIP, and TKB 
that you are finished and the task may exit. CTRL/Z 
is echoed as “~Z. 


2.4.3 Terminal Privilege 


You can issue privileged commands only from a privileged terminal. On 
multiuser protection systems, individual users are either privileged 
or nonprivileged. When you log in, the terminal assumes your 
privilege status. On other systems, a terminal's privilege status is 
determined initially at system generation. You can also use the SET 
/({NO]PRIV command (see Chapter 3) at a privileged terminal to modify 
the privilege status of your own and any other terminal connected _ to 
the system. 


CAUTION 
You must take great care when any 
terminal is privileged. Privileged 
commands can destructively interfere 


with system operation. 


2.4.4 Attached and Unattached Terminals 


A terminal is attached when all input and output are directed to or 
from a task other than MCR. For example, when you invoke a task (such 
as the text editor EDI), the task usually attaches to the terminal so 
that no other task can use the terminal for I/O. When you wish to 
exit (by typing CTRL/Z, for example), the task is detached from the 
terminal and subsequent input is usually directed to MCR. 


Since an attached terminal directs all input to the dedicated task, 
you must either exit from the task or type CTRL/C to gain MCR's 
attention before attempting to communicate with MCR. (See Section 
1.1.1 for a description of CTRL/C as a means of temporarily gaining 
MCR's attention.) 
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See the RSX-11M/M-PLUS I/0 Drivers Reference Manual for more 
information on terminals and terminal drivers. 


2.4.5 Slaved Terminals 


You can dedicate a terminal exclusively to one or more tasks by 
issuing a SET command option that sets the terminal to slave status. 
(A special I/O function issued by a task can also set a terminal to 
Slave status.) The difference between a slave terminal and an attached 
terminal is that a slave terminal rejects all unsolicited input, 
including CTRL/C, but excepting CTRL/O, CTRL/Q, and CTRL/S. Attached 
terminals, as described in the preceding section, do accept CTRL/C. 


Until you issue another MCR command (or a task issues another’ special 
I/O function) to delete the slave status, the terminal can only be 
used to communicate with tasks soliciting input from the terminal. 
Slaved terminals are often dedicated to real-time applications. 


See the RSX-11M/M-PLUS I/O Drivers Manual for more information on 
terminals and terminal drivers. 


2.5 TASKS 


The basic executable unit of an RSX-11M/M-PLUS system is the task. A 
task is either privileged or nonprivileged. A privileged task has 
special device and memory access rights that a nonprivileged task does 
not have. Because of their special access rights, privileged tasks 
are potentially hazardous to a running system whereas nonprivileged 
tasks are not. 


The following sections give oniy cursory information about tasks. 
Consult the RSX-11M/M-PLUS Task Builder Manual for a _ complete 
description. 


2.5.1 Partitions 


A task runs in a predetermined contiguous area of memory called a 
partition. A partition has the following characteristics: 


e A name 
e A defined size 

_@ A fixed starting address 
e A defined type 


The relationship between a task and the partition in which it runs 
depends on whether the system is mapped or unmapped. RSX-11M-PLUS 
systems are always mapped. In an unmapped RSX-11M system, a task can 
run only in aepartition that has the same starting address as the 
partition for which the task image was created by the Task Builder. 
In mapped systems, however, a task can run in any partition that is 
large enough to contain it. 
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2.5.1.1 Partition Types - There are two types of partitions in which 
tasks can execute: 


e System-controlled 


e User-controlled 


In a system-controlled partition, the Executive allocates available 
space to accommodate as many tasks as possible at any one time. This 
allocation may involve shuffling resident tasks to arrange available 
space into a contiguous block large enough to contain a requested 
task. Only mapped systems support system-controlled partitions. 


In both types of partitions, the Executive can temporarily move 
(checkpoint) a resident task to a disk to make space available for 
another task. 


2.5, L. 2°. Subpartitions - - RSX- 11M. users can subdivide. a user- ~controlled 
partition ‘into. as. many as. seven nonoverlapping subpartitions. Like 
its parent main partition, a subpartition can contain only one task at 
one» time. Since the subpartitions occupy the same physical memory. as 
‘the main partition, tasks cannot be simultaneously resident in both 
, main. ‘partition. and. one Or more subpartitions. But since each 
artition can contain a task, uP to Seven ‘tasks can potentiality run. 


= 1M uses.  cubpareitions: ‘to. rectatm large latgrage: areas” in’. uanmepped 
systems. | For example, — when a large task that requires a main 
partition is either no longer . active ore can be checkpointed, 
: partitioning Allows the Parct tion eee fo. be used for a abe: 
smaller tasks. 9. oe Se eae ee * as ees 


2.5.2 Multiprogramming 


Tasks compete for system resources (including memory) on the basis of 
Priority and resource availability. The priority of a task is 
determined by a number assigned when the task is created by the Task 
Builder, when it is instalied, or when it is run. The number is in 
the range 1 through 250({10}), where 250 is the highest priority. The 
highest priority task that has access to and can use all the resources 
it needs has control of the CPU. 


A task often becomes blocked when it requests system services. For 
example, it can block itself as it waits for an I/O transfer to 
complete. While the task is blocked in this way, the Executive looks 
for another task to use the CPU. The chosen task will be the one that 
has the highest priority and whose needed resources are available. 
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2.5.3 Creating a Task 
You perform four steps to create a task and prepare it for execution: 


1. Enter a program in a supported source language through an 
editor. 


2. Submit the source code to _ the appropriate translator 
(assembler/compiler) to produce an object file. 


3. Submit the object file to the Task Builder to produce a_ task 
image file. 


4. Use the INSTALL command to install the task image file in the 
system or use the install-run-remove option of the RUN 
command (see Section 2.5.5.1). 


The output files that result from Steps 1, 2, and 3 are each stored on 
a Files-11 volume. 


2.5.4 Task-Naming Convention 


Sern Gee have teri 
of the xxxTnn nam: 
active. installed tas! 
than 77, the bask will 
Messages ue 


: cpumber” ais” “greater 
you will get an error 


Note that. the” naming “Co eS 
the RUN command. eee RR eee et ce ee 
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example, ie you es ae ‘Erom"?T1002¢ MCR” ‘runs a ‘task called 
) to abort PIPTAG: + rom Pr Eeas chee the: command * Pe ce 


the. correct copy. OF PIPL However, to abort _ “PTLOO:'s 
i dehie. (tskTnn) or use the ABORT Kgumandt a: ‘/TERM Ke 
sae either | of She: eee ere lines” ‘issued 


2.5.5 Installing a Task 


When you install a task with the INSTALL command or a form of the RUN 
command, the system records a number of task parameters in a 
system-resident list called the System Task Directory (STD). These 
parameters include the name of the task and the address on the volume 
that contains the task image. An installed task is defined as a_ task 
that has an entry in the STD; it need not be resident in memory nor 
competing for ets Peeouneee. The system considers a task dormant 
(not active) until a request is made for it to run. 


EAN 
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The concept of dormant and active tasks is important in a real-time 
system. A dormant task does not use any memory outside of the 
Executive (it requires only an STD entry and need not be resident), 
yet when the task is needed to service a real-time event, the 
Executive quickly and efficiently introduces it into active 
competition for system reSources. An installed task's STD entry 
enables this quick response because the STD contains all the 
parameters the system needs to retrieve the requested task. 


You can run an installed dormant task by issuing the RUN command, or 
another task can request the task to run by issuing an Executive 
directive, such as ROSTS (Request), RUNS (Run), or SPWNS (Spawn). 


When the Executive receives a request to run a task, it performs a 
series of actions: 


1. Places the task in active competition for system resources 
(including memory) with other resident tasks. 


2. Allocates the necessary resources as they become free. 


3. Brings the task into memory when there is space available in 
its partition. (The Executive can checkpoint a _ lower 
priority checkpointable task, if there is one, to make room 
for the requested task.) 


If another task fully occupies the partition in which the new task is 
to be installed and no resident task can be checkpointed, the system 
places the task in a queue of other requested tasks, each waiting for 
Space to become available in its partition. Note that the number of 
installed dormant tasks can, and usually will, far exceed the number 
of active tasks. 


Install-—-Run-Re 


edued Econ TT1e Ob from a inal also. aborts. the. wack 
originally | referred fo 88 * RUN command Assued from 
terminal IES Sige ia S 
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2.6 NONPRIVILEGED USE OF ACNT 


RSX-11M/M-PLUS systems provide an Account File Maintenance Program 
(ACNT) for creating and maintaining an account file for a multiuser 
protection system. The account file contains entries for all the UICs 
that have been authorized for use in the system. One UIC can be 
shared by several users, each user having his or her own password. 


A nonprivileged user can run the ACNT program to change his or her 
password. All other ACNT options are privileged. The ACNT task must 
first be installed by a privileged user before a nonprivileged user 
can run it. 


When you run the ACNT program, it identifies itself and immediately 
prompts for your current password. ACNT then searches the account 
file for the entry that matches the UIC and _ password. When ACNT 
locates the correct entry, it prompts you for the new password or an 
ESCape. If you enter a new password, ACNT changes your current 
password to the new one. If you press the ESCape key, ACNT leaves 
your current password unchanged. The prompt also shows the maximum 
character length allowed for a password. 


If you do not enter your current password or enter it incorrectly, 
ACNT issues an error message and exits. You must run the ACNT program 
again to change your password. 


After ACNT changes the password or you press the ESCape key, ACNT 
displays the message OPERATION COMPLETE and exits. 


See the RSX-11M/M-PLUS System Management Guide for more information on 
ACNT and its privileged options. 
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Examples: 


>RUN ACNT 

* ACCOUNT FILE MAINTENANCE PROGRAM * 
Password ( <=6 chars. ): ANGEL 
Type <ESC> to leave entry unchanged 
Password ( <=6 chars. ): ESC 
OPERATION COMPLETE 


>RUN ACNT 

* ACCOUNT FILE MAINTENANCE PROGRAM * 
Password ( <=6 chars. ): ANGEL 
Type <ESC> to leave entry unchanged 
Password ( <=6 chars. ): DEVIL 
OPERATION COMPLETE 


>RUN ACNT 

* ACCOUNT FILE MAINTENANCE PROGRAM * 
Password ( <=6 chars. ): ANGEL 
Type <ESC> to leave entry unchanged 
Password ( <=6 chars. ): TOOLONG 
ACNT ~--— Syntax or command input error 
OPERATION COMPLETE 


>RUN ACNT 
* ACCOUNT FILE MAINTENANCE PROGRAM * 
Password ( <=6 chars. ): JANGEL 
ACNT -- Cannot find account 
OPERATION COMPLETE 


CHAPTER 3 


MCR COMMANDS 


This chapter describes all of the MCR commands. The commands are in 
alphabetical order regardless of function or privilege status. 


The descriptions of the commands and messages given in this’ chapter 
observe the following notational conventions: 


e Lowercase text indicates a variable whose actual value is 
determined when the command is entered or the message is 
issued. For example, the value of "taskname" depends on the 
name of the task associated with the command or message. 


e Square brackets ([]) indicate optional entries in a command 
line or file specification. Note that when an option is 
entered, the brackets are not included. 


Square brackets are also a part of the User File Directory 
(UFD) and User Identification Code (UIC) syntax ([group, 
member]). When you use a UFD or UIC (in a file specification, 
for example), brackets are required syntax elements; that is, 
they do not indicate optional entries. 


e Unless explicitly qualified, all numeric values required in a 
command can be entered as decimal or octal. Decimal values 
are indicated by a trailing period (.); octal values are 
indicated by the absence of the period or by a pound sign (#) 
preceding the number. Thus, 


2556 
and 

377 
and 

#377 


have the same value. (The value 255. is base 10; the value 
377 is base 8.) 


The following subheadings appear in the detailed command descriptions 
that follow. Subheadings that do not apply to a particular command 
are Simply omitted from the command description. 
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COMMAND NAME 


This heading identifies the command name in capital letters. The 
minimal MCR command abbreviation is shown on the upper right or left 
margin. The text following this subheading describes the command's 
function. A (NP) following the command name indicates that the 
command is nonprivileged. A (P) following the command name indicates 
that the command is privileged. A (NP,P) indicates a nonprivileged 
command with privileged options. A (P,NP) indicates a_ privileged 
command with nonprivileged options. 


Format 


This subheading is followed by the command format and a description of 
all parameters. 


Command-Related Error Messages 


Error messages specific to the command appear under this subheading. 
The command may also produce the common error messages listed in 
Appendix A. These common error messages are not listed with the 
individual commands. 
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ABO 


ABORT (NP,P) 


The ABORT command terminates execution of a specified task. 
Nonprivileged users can abort nonprivileged tasks requested from the 
issuing terminal on systems with multiuser protection or any 
nonprivileged task on systems without multiuser protection. 
Nonprivileged users can also abort privileged tasks requested from the 
issuing terminal if the tasks have requested an exit AST service 
routine with the SREXS form of the SPECIFY REQUESTED EXIT AST 
Executive directive. Privileged users can abort any task. 


When a task that has specified an exit AST service routine is aborted, 
it enters the routine instead of being aborted immediately. 
Privileged tasks enter the specified AST routine each time a valid 
abort request is issued. However, future exit ASTs are not queued 
until the first exit AST has been effected. Nonprivileged tasks enter 
the specified AST routine only once. After that, any valid attempt to 
abort the task succeeds. 


See the RSX-11M/M-PLUS Executive Reference Manual for more information 
on the SPECIFY REQUESTED EXIT AST directive. Note that the issuing 
terminal receives no indication that the task being aborted was 
actually aborted or that it received the abort AST instead. 


Aborting a task forces an orderly termination of the specified task. 
To effect the termination, the system: 


e Performs I/O rundown. Cancels I/O for all non-file-structured 
devices. Allows I/0 for file-structured devices to complete 
and then deaccesses the files. Detaches all attached devices. 
(I/O rundown may take a considerable amount of time for tasks 
connected to a network node.) 


e Requests the Task Termination Notification program (TKTN) to 
display a message on the aborted task's issuing terminal 
giving the reason for the termination. (If the /PMD keyword 
is specified and the task is not checkpointed, the task's 
registers are also displayed.) 


e Releases the task's partition if the task is not fixed. 


e If the system supports the ALTER PRIORITY directive (a system 
generation option), alters the task's running priority to 247 
(unless the exit AST service routine has been specified). A 
task must be memory-resident to be aborted; this change in 
running priority usually causes a quick return for a 
checkpointed task. 


If the command includes the optional keyword /PMD, it forces’ the 
system to produce a postmortem dump of the aborted task. The dump is 
generated even if the task was not built with the Task Builder /PM 
switch or installed with the INSTALL /PMD=YES keyword. 

Format: 


ABO[RT] taskname[/PMD] [/TERM=TTnn: ] 
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ABO (Cont.) 


taskname 


The name of the task to be aborted. If you omit the taskname, 
the command attempts to abort task TTnn. (The variable nn is the 
octal unit number of the issuing terminal.) 


Likewise, if you specify only the first three characters of the 
taskname, ABORT defaults the taskname to tskTnn. 


/ PMD 


Examples: 


>ABO MAC 
Task "MACT3 " terminated 
Aborted via directive or CLI 


MCR (the command line interpreter for these examples) aborted 
a task called MACT3, even though the command, issued from 
TT3:, Specified only the 3-letter task name. 


On RSX-11M and RSX-11M-PLUS systems, the command >ABO MACT3, 
issued from any privileged terminal, would have the same 
effect. 


>ABO 
Task “TT7 " terminated 
Aborted via directive or CLI 


MCR aborted the task, TT7, from TT7:; the task name does not 
have to be specified to abort task TTn. 


Command Error Messages: 


On receiving an ABORT command, MCR requests the Executive to 
abort the task. The Executive subsequently activates the Task 
Termination Notification program (TKTN). TKTN then produces'- the 
termination display shown in the examples. Messages following an 
ABORT command can therefore come either from the ABORT command 


itself or from TKTN. 
Messages from ABORT command: 
ABO -- TASK MARKED FOR ABORT 
A previous request has already been made to abort the 
specified task, but the abort has not yet occurred. The 
task marked for abort is probably not currently resident in 


memory or it has outstanding I/O (for example, an MM: 
tape-positioning operation must complete). 
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ABO -- TASK NOT ACTIVE 


The specified task is not currently active. 


Messages from Task Termination Notification program (TKTN): 


TKTN displays information about task aborts, whether caused by 
the ABORT command or by some other means. The display has the 
format: 


TASK "taskname" TERMINATED 
abort cause 


Following the displayed cause for the abort is a list of the 
task's registers at the time of the abort (if the task was not 
checkpointed). The possible causes of an abort are described in 
the following messages: 

ABORTED VIA DIRECTIVE OR CLI 


Either an Executive directive or a CLI command issued by 
another task caused the task to be aborted. 


ABORTED VIA CLI 
POSTMORTEM DUMP WILL BE GENERATED 


A CLI command aborted the task and requested a Postmortem 
Dump. 


11/40 F.P. EXCEPTION 
The task encountered a floating point exception while 
executing on a PDP-11/40 and no SST routine was specified to 
process the trap. 


AST ABORT. BAD STACK 


An AST could not be effected because the AST parameters 
could not be pushed onto the task's stack. 


CHECKPOINT FAILURE. READ ERROR 


The task could not be read back into memory after being 
checkpointed. 


IOT EXECUTION 


The task executed an IOT instruction and no SST routine was 
specified to process the trap. 


LOAD FAILURE. READ ERROR 


The task could not be loaded because of a hardware error. 
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MEMORY PROTECT VIOLATION 


The task encountered a memory-protect violation and no _ SST 
routine was specified to process the trap. 


NON-RSX EMT EXECUTION 


The task executed an EMT instruction with an argument other 
than 377(8) or, in the case of a privileged task switching 
to system state, 376(8), and no SST routine was specified to 
process the trap. 


ODD ADDRESS OR OTHER TRAP FOUR 


The task executed a word instruction with an odd address or 
referenced a nonexistent memory location in an unmapped 
system, and no SST routine was specified to process’ the 
trap. 


PARITY ERROR 
A parity error occurred while the task was executing. The 


task was fixed in memory so that the memory could not be 
reused by another task. 


IRED BUS RUNS ARE 


RESERVED INST EXECUTION 


The task executed an illegal instruction and no SST routine 
was specified to process the trap. 


SST ABORT. BAD STACK 


= SST could not be effected because the SST parameters 

ould not be pushed onto the task's' stack, or a stack 
socreiow was detected in an unmapped system, as indicated by 
a nonzero value in the header guard word. 


TASK EXIT WITH OUTSTANDING I/0 
The task exited with one or more outstanding I/O requests. 


Tasks should terminate all I/O operations before exiting. 
The system does, however, process all outstanding I/0. 
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TASK INSTALLED IN MORE THAN ONE SYSTEM 


The task image file has been installed in more than one 
system. When a task is installed, pointers to various 
system data structures are stored in the task header in the 
task image file. If a task is installed in more than one 
system, the header contains pointers for the last system in 
which the task was installed. When the task is loaded for 
execution, the loader verifies that the header contains 
valid pointers for the current system. When a task has been 
installed in more than one system, the loader check fails 
and the task is aborted. 


T-BIT TRAP OR BPT EXECUTION 
The task either set the T-bit in the Processor Status Word 


or executed a  Breakpoint Trap instruction, and no SST 
routine was specified to process the trap. 


TRAP EXECUTION 


The task executed a TRAP instruction and no SST routine was 
specified to process the trap. 
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ACS 


ALLOCATE CHECKPOINT SPACE (P) 


The ALLOCATE CHECKPOINT SPACE (ACS) command allocates or discontinues 
a checkpoint file on disk for systems that support the dynamic 
allocation of checkpoint space. The disk containing the checkpoint 
file must be in Files-11 format. Only one checkpoint file per disk is 
allowed, but numerous disks can each contain a checkpoint file. In 
general, sufficient checkpoint space is twice the total amount of 
memory that all of the running tasks will use. 


When the system needs checkpoint space, it searches the checkpoint 
files in the order in which they were created. If space is not 
available in the first file created (the primary file), it searches 
for space in the second file created (the secondary file), and so on. 


An ACS command that discontinues a checkpoint file may not take effect 


immediately. If the specified file contains one or more checkpointed 
tasks, the tasks must be returned to memory before the system can 
discontinue the file. However, once the request to discontinue the 


file has been made, the system does not use the file for any more 
checkpointed tasks. 


Format: 
ACS ddnn:/BLKS=n 
ddnn: 


A device unit that contains a mounted Files-1l disk. If the unit 
number (nn) is not specified, it defaults to 0. 


/BLKS 


/BLKS=n. A keyword that specifies the number (n) of blocks’ on 
the disk to be allocated for the checkpoint file. (A block is 
512 decimal bytes.) For example, the command 


>ACS DB:/BLKS=250. 
allocates 250(10) blocks for a checkpoint file on DB:. 


When n is 0, the system discontinues the use of the checkpoint 
file; the file is neither deleted nor truncated. However, the 
use of the file is discontinued only after all of the tasks that 
are checkpointed to it can be brought into memory and 
checkpointed eisewhere. 


For example, the command 
>ACS DB:/BLKS=0 


discontinues the checkpoint file on disk DBO:. This does not 
mean that the space allocated to the checkpoint file is freed. 
The system checkpoint file [0,0]CORIMG.SYS retains the space 
initially allocated by the ACS command so that the space will be 
available the next time it is needed. If you want to free the 
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space allocated to the system checkpoint file after its use has 
been discontinued, use the following commands: 


>ACS ddnn:/BLKS=0 
ACS -- CHECKPOINT FILE NOW INACTIVE 
>PIP [0,0]CORIMG.SYS/TR 


You must set the block size of the checkpoint file to 0 to 
discontinue it before you can truncate it. Do not issue the PIP 
command line until the "Checkpoint file now inactive" message has 
been displayed. PIP cannot determine if the checkpoint file is 
still in use, so issuing the command line could cause volume 
corruption and/or a system crash. 


Examples: 


>ACS DS:/BLKS=250. 
>ACS DB:/BLKS=1024. 


Allocates a primary checkpoint file on DS: and a_ secondary 
checkpoint file on DB:. The primary file is 250(10) blocks 
long and the secondary file #s 1024(10) blocks’ long. When 
the system searches for checkpoint space, it will first look 
in the file on DS: and then in the file on DB:. 


>ACS DS:/BLKS=0 
Discontinues use of the checkpoint file on DS:. 
Command Error Messages: 
ACS -- CHECKPOINT FILE ALREADY IN USE ON DEVICE 
A previous ACS command established a checkpoint file on the 
volume mounted on the specified device unit. A volume can 
contain only one checkpoint file. 


ACS -- CHECKPOINT FILE NOW INACTIVE 


This message appears after you issue an ACS command _ to 
discontinue a checkpoint file and the file does not contain 
any checkpointed tasks. The message indicates that use of 
the file was discontinued immediately after the command was 
issued. If the file is still in use, MTKTN will issue a 
message when the file is finally discontinued. 


ACS -- | DYNAMIC ALLOCATION 0 


ORT SPACE NOT. SUPPORTED 


one ACS: Command was esued on an RSX- LIM system ‘that. aia. not 

-., Include support of. dynamic allocation of. checkpoint space at 
system Gener aeion. (ALE RSX-1IM- ‘PLUS eae include cis: 
. feature. ) aye Piss ae . : 
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ACS 


ACS 


ACS 


Kk 


kK 


-- FILE I/O ERROR nnn. 
The ACS command detected an error when it tried to allocate 
or open the checkpoint file. The code nnn. is an FCS error 
code that defines the cause of the error. See the 
IAS/RSX-11 I/O Operations Reference Manual. (If the code is 
-24, the message may indicate that the disk, usually a 
fixed-head disk, does not have enough contiguous space to 
allocate the file. The normal implication of the code -24 
is "device full".) 
-- FILE NOT IN USE 
A checkpoint file was not in use on the device specified in 
the ACS command. 
-- NOT FILES-11 DEVICE 
The command specified a device that did not contain a 
Files-11 disk. The specified device unit must contain a 
mounted Files-1l1l disk. 
ddnn: -- CHECKPOINT FILE NOW INACTIVE 
The message, issued by TKTN, indicates that a request to 
discontinue use of a checkpoint file on device ddnn: has 
finally been satisfied. The need to return checkpointed 
tasks from the discontinued file back into memory caused the 
delay between the request and this message. 
tsknam CHECKPOINT SPACE ALLOCATION FAILURE 


The task could not be checkpointed because there was not 
enough room in the system checkpoint file and checkpoint 
space was not allocated in the task image file. Either make 
the system checkpoint file bigger or create a second one. 


Note that tasks built with the /AL switch are checkpointed 
to their task image file if the system checkpoint file is 
Full. 
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ACT 


ACTIVE (NP) 


The ACTIVE command displays at the entering terminal the names of all 
active tasks that have that terminal as their TI:. On RSX-11M-PLUS 
systems, the display includes the octal unit number of the terminal 
that initiated each task. 


When the ACTIVE command is issued with /ALL (ACT /ALL), the names of 
all active tasks in the system are displayed. 


The ACTIVE command can also be issued with /TERM (ACT /TERM=TTnn:) to 
display the names of all the active tasks for a specific terminal. 


Format: 
ACT[IVE] [/keyword] 
/keyword: 


/ALL 
/TERM=TTnn: 


Examples: 
RSX-11M systems 


>ACT 
MCR... 
«e-MCR 
>ACT /ALL 
RMDEMO 
MCR... 

- «MCR 
FI1ACP 
teePlP 
>ACT /TERM=TT7: 
«+P LP 

> 


RSX-11M-PLUS systems 


>ACT 

MCR. CPETI7 =} 
ACTT17 (TT17:) 
> 

>ACT /ALL 
LDR... (COO0:) 
RMDEMO (TT62:) 
MCRess (CPTI s) 
F1L1ACP (COO0:) 
DSOOF1 (CO0:) 
DSO1F1 (CO0:) 
LSTACP (CO0:) 
DBO3F1 (CO0:) 
AT.V6 (VT6: ) 
QMG... (CO0:) 
HRC... (COO:) 
PIPTAL (TTi01:) 
> 

>ACT /TERM=TT107: 
LBRTA7 (TT107:) 
> 


MCR COMMANDS 
ALL 


ALLOCATE (NP,P) 


The ALLOCATE command establishes a specified device as your. private 
device. (This command applies only to RSX-11M systems that support 
multiuser protection and all RSX-11M-PLUS systems.) Device allocation 
prevents other nonprivileged users from accessing a device (see 
Section 2.3.5). Only the device's owner or a_eprivileged user can 
access or deallocate a private device. 


Mounted devices, public devices, or other users' private devices 
cannot be allocated. 


The system automatically deallocates your private devices when you log 
out (issue the BYE command). 


You can also allocate a device to a specific terminal rather than _ to 
TI:. This allows you to allocate a device to a virtual terminal. 


Format: 
ALL[OCATE] dd{nn:] [=llnn:] [/keyword] 

dd 
The device mnemonic of the device-unit to be allocated. 

nn: 
The optional device-unit number. If the number is omitted, the 
system allocates the first available logical unit of the dd-type 
device and displays the allocated device in the following format: 

ALL -- ddnn: NOW ALLOCATED 

linn: 
The optional name of a logical device, which the system creates 
and assigns to the physical device being allocated. (This is a 
local assignment as created by the ASSIGN command.) Specifying a 
logical device name is helpful when using the /TYPE keyword in an 
indirect command file. 

/keyword 
One of the following: 

/TERM=TTnn: 


Specifies the terminal number (TTnn:) to which the device 
is to be allocated. 


/TYPE=dev 


Specifies the type of device wanted when doing a_ generic 
allocation. Instead of allocating a specific device, the 
command allocates the first available device of the 
specified type. dev is the physical name of the device 
(for example, RPO6, RKO7). 
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ALL (Cont.) 


On RSX-11M 


for .the following 


devices: 
RA60 «-RKOG..~—s-RPO3.—«RMOS 
-RA80/81 RKO7 == -RPOS = RM80- 


REQ oe @RLOY  RPOG <  RSO3. 


Examples: 
>ALL DK2: 
Allocates disk DK2:. 
>ALL DK: 
Allocates disk DKO:. 
>ALL DK1:/TERM=VT1: 


Allocates disk DK1: to the specified virtual terminal, 
VTLes 


>ALL DK=XxX0: 
ALL -- DK3: NOW ALLOCATED 


Allocates the first available logical unit of DK (in this 
case, disk DK3:, since units 0, 1, and 2 were allocated 
previously or are public devices) and assigns it the logical 
name XX0:. 
>ALL DB/TYPE=RP06 
Allocates any available RPO6 disk. 
Command Error Messages: 


ALL -- DEVICE ALLOCATED TO OTHER USER 


The specified device has already been allocated by another 
user. 


1. The formatter name appears only if the drive is not a 
TU45/TU77/TU78/TE16. 
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ALL (Cont.) 


ALL 


ALL 


ALL 


ALL 


ALL 


ALL 


-- DEVICE ATTACHED 


The specified device cannot be allocated because it is 
attached to a running task. 


-- DEVICE dd: NOT IN SYSTEM 


The specified device driver does not exist in the system, or 
the data base for the device driver is not in the system or 
in the driver's task image. 
-- INVALID KEYWORD 


The specified keyword cannot be used with the ALLOCATE 
command. 


-- PSEUDO DEVICE ERROR 


The specified device is a pseudo device. Pseudo devices 
cannot be allocated. 


-- PUBLIC DEVICE 


The command attempted to allocate a public device. Public 
devices cannot be allocated. 


-- USER LOGGED ON TERMINAL 
The command attempted to allocate a terminal that has been 


logged-in by another user. Logged-in terminals cannot be 
allocated. 
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ALT 


ALTER (P) 


The ALTER command changes the static or running priority of an 
installed task. 


Format: 
ALT[ER] taskname /keyword(s) 
taskname 
The name of the task whose priority is to be altered. 
/keyword(s) 
One or more of the following: 
/PRI=n 
Changes the task's static priority, and, if the system 
Supports the ALTER PRIORITY directive, the task's running 
priority. (All RSX-11M-PLUS systems support the directive.) 


/RPRI=n 


Changes the task's running priority only (valid only in 
systems that support the ALTER PRIORITY directive). 


The priority is in the range 1 to 250(10). The system assumes’ that 
the priority you specify is octal unless you include a period (.). 


Examples: 
RSX-11M systems 
>ALT TEST /PRI=40. 


Alters the static and running priority of task TEST to 
60(10). 


>ALT CMFRUN /RPRI=70. 
Alters the running priority of task CMFRUN to 70(10). 
RSX-11M-PLUS systems 
>ALT ABC/PRI=100./TERM=TT6: 


Alters the static and running priority of task ABCT6 to 
100(10). 
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ASN 


ASSIGN (NP,P) 


The ASSIGN command defines, deletes, or displays logical device 
assignments. Logical device assignments associate logical names with 
physical devices, pseudo devices, or other logical devices. When you 
assign a logical name to a pseudo or logical device, the system 
resolves the assignment to the associated physical device. There are 
three types of logical device assignment: global, local, and login. 


e Global assignments apply to all tasks running in the system. 
Only privileged users can issue ASN commands to define or 
delete global assignments. 


@ Local assignments apply only to tasks initiated from the 
terminal used to make the assignments. Any terminal can 
define or delete its own set of local assignments. 


e Login assignments occur only in RSX-11M systems that support 
multiuser protection and all RSX-11M-PLUS systems. When a 
user issues a HELLO command to log into the system, the system 
automatically assigns the logical name SY: to the user's 
system device, which is the device that contains the user's 
files. The login assignments apply only to tasks initiated 
from the terminal while the current user is logged in. Only 
privileged users can define or delete login assignments. 


The system uses local assignments before it uses login and global 
assignments, and login assignments before global assignments. If you 
make a local assignment using a logical device name that is already 
used in a login assignment, the system uses the local assignment. 
When you delete the local assignment (using ASN=), the system goes 
back to using the login assignment. 


A logical-device name has the same syntax as a real device unit; it 
consists of a 2-character ASCII name (alphabetic) and an optional l1- 
or 2-digit octal unit number, followed by a colon (:). The 


2-character name can either be equivalent to a standard RSX-11M/M-PLUS 
device name (for example, DK:) or it can be two letters picked at 
random (for example, 22Z:). 


When you install a task or the system processes an ASSIGN’ LUN 
directive, the system scans the logical device table before the 
physical device table when searching for a specified device. As a 
result, a user can define logical device names that are identical to 
physical device names even though the logical and physical device 
names do not refer to the same physical device. The system resolves a 
specified device name to the first matching table entry found. 
Therefore, if a logical device name is identical to a physical device 
name, the logical name has precedence. 


The following legend explains the terms used in the descriptions of 
the various ASN formats for nonprivileged and privileged users. 
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ASN (Cont.) 


PP 


The physical, logical, or pseudo device name. 
nn 


The unit number. 


ro 
ft 


The logical device name. 
tt 
The terminal device name. 
Nonprivileged formats: 
ASN ppnn:=llnn: 


Assigns the logical name llnn: to device ppnn:. The command 
establishes a local assignment for the issuing terminal. 


Displays all local and login logical-device assignments’ for 
the issuing terminal. 


ASN =[llnn:] 
Deletes the local assignment of the specified logical-device 
name; or deletes all local logical-device assignments for 
the issuing terminal if the command omits llnn:. 
Privileged formats: 


ASN ppnn:=llinn:/GBL 


Defines a global assignment that associates the logical name 
linn: with device ppnn:. 


ASN /GBL 


Displays all global, local, and login assignments for all 
terminals in the system. 


ASN =[llnn:]/GBL 


Deletes the specified global logical-device assignment; or 
deletes all global assignments if the command omits llnn:. 


ASN ppnn:=linn:/LOGIN[/TERM=ttnn: ] 
Establishes a login logical-device assignment for a 
specified terminal or for the issuing terminal if the 
command omits /TERM=ttnn:. 


ASN /TERM=ttnn: 


Displays all local and login logical-device assignments for 
the specified terminal. 


ASN (Cont.) 


ASN 


ASN 


Example: 


>ASN 
>ASN 
>ASN 
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=linn:/LOGIN[/TERM=ttnn: ] 


Deletes the login logical-device assignment indicated by the 


name linn: £ 


or 


specified terminal or for the issuing 


terminal if the command omits /TERM=ttnn:. 


=/LOGIN([/TERM=ttnn: ] 


Deletes all login 
specified terminal 


logical-device assignments for the 
or for the issuing terminal if the 


command omits /TERM=ttnn:. 


=flinn:]/TERM=ttnn: 


Deletes the local logical-device assignment indicated by the 


name linn: £ 


or 


the specified terminal; or deletes all 


local logical-device assignments for the specified terminal 
if the command omits llnn:. 


DP:=SY: 
DP:=USI1: 
DT:=US2: 
DK: =GB0:/GBL 


DIOs LOCAL 
DPO: LOCAL 


DPO: LOGIN 
/GBL 
DITO: LOCAL 


DPO: LOCAL 
DPO: LOGIN 
DKO: GLOBAL 
=US2: 


=/GBL 
=US1: 


DK:=XY: 
XY:=Z2: 


gues 
gigs 
TI 


ye 
TI 
ya 


!Define SY: 

!Define USL: 

!Define US2: 

!Define global logical device name GBO: 
!List local and login assignments 
TTOs 

TTO: 

TTO: 

!tList all assignments 

TTO: 

TTO: 

TTO* 


!Eliminate local logical device name 


!Eliminate all global assignments 

!Eliminate local logical device name 
US1* 

!Assign XY: to DK: 

!Assign ZZ: to XY: 

!Display assignments 


DKO: LOCAL <TI=TTO: 
DKO: LOCAL TI-TTO: 


Command Error Messages: 


ASN -- DEVICE NOT TERMINAL 


The /TERM keyword used in the ASN command did not specify a 


terminal. 


The specified logical device name was not included in _ the 
system at system generation and therefore could not be found 
in the logical device assignment table for the terminal. 
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ATL 


ACTIVE TASK LIST (NP) 
The ACTIVE TASK LIST (ATL) command displays the name and status of all 
active tasks in the system or the status of a particular task. The 
display provides information useful for determining the exact status 
of each active task. The display contains the following information 
for each task: 

e Task name 

e Task control block physical address (octai) 

@® Partition name 

e Partition control block physical address (octal) 

@ Partition base and limit physical addresses (octal) 

e Task's running priority and default priority 

e Task status flags 

e TI: terminal physical device-unit 

e Nonbuffered and buffered I/O counts (decimal) 


e Task local event flags 


e Task registers and Processor Status Word (memory-resident 
tasks only) 


The displayed task status flags are from the Task Control Block (TCB) 
or the Partition Control Block (PCB). The ATL command displays the 
name of the bit if the bit is set to 1 at the time of the display. 
Bits set to 0 are not displayed. Flag names are three characters long 
and correspond to the last three characters of the mnemonic defining 
the status bits. For example, AST represents the bit T2.AST and 
indicates that the task is processing an Asynchronous System fTrap. 
Names prefixed by aminus sign (-) indicate that the bit represents 
the complement of the condition. For example, -CHK indicates that the 
task is not checkpointable. 


If the task is not in memory (the OUT flag is displayed), the contents 


of the PC (program counter), the PSW (Processor Status Word), and the 
registers are not displayed. 
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ATL (Cont.) 


The following list gives the flag names and a brief explanation of 
each one. 


Status Description 

ABO Task is being aborted. 

ACP Task is an Ancillary Control Processor (ACP). 

AST Task is processing an AST. 

BLK Task is blocked by a CLI command. 

CAF Task cannot be checkpointed due to checkpoint space 
allocation failure. 

CAL Checkpoint space is allocated in task image. 

-CHK Task is not checkpointable. 

CIP Task is blocked for checkpoint in progress 
(RSX-1L1M-PLUS). 

CKD Task has checkpointing disabled (RSX-11M). 

CKP Task is checkpointed (RSX-11M) or blocked for 
checkpoint in progress (RSX-11M-PLUS). 

CKR Task checkpoint request pending. 

CLI Task is a CLI task. 

CMD Task is executing a CLI command (RSX-11M-PLUS). 

DSP Task was built with separate I- and D-space 
(RSX-1L1M-PLUS). 

DST Task ASTs are disabled. 

-EXE Task is not in execution. 

FXD Task is fixed in memory (RSX-11M) or partition is fixed 
in memory (RSX-11M-PLUS). 

GFL Task has its group global event flags locked. 

HLD Task is half-loaded (RSX-11M). 

HLT Task is being halted. 

LDD Task's load device has been dismounted (RSX-11M-PLUS). 

MCR Task was activated by MCR. 

MPC Task has mapping change and outstanding I/O 
(RSX-1LIM-PLUS). 

MSG Task aborted, waiting for TKTN message. 

MUT Task is a multiuser task (RSX-11M-PLUS). 

NET Network protocol. 

NRP Task is mapped to nonresident partition (RSX-11M). 

NSD Task cannot receive data (no send data allowed). 

~PMD Suppress Postmortem Dump on SST abort. 

OUT Task is out of memory (RSX-11M) or partition is out of 
memory (RSX-11M-PLUS). 

PRO Task has prototype TCB (RSX~11M-PLUS). 

PRV Task is privileged. 

PRVD Task was privileged but has been set nonprivileged 
(RSX-1LIM-PLUS). 

RDN Task I/O is being run down. 

REM Task is to be removed on exit. 

REX Task has abort AST effected or in progress. 

ROV Task has resident overlays. 

RST Task is restricted (used by layered software). 

RUN Task is executing on another processor (RSX-LIM-PLUS 
multiprocessing systems only}. 

SEF Task is stopped for an event flag(s). 

Sto Task iS waiting for terminal I/O (RSX-11M-PLUS). 

SLV Task is slaved. 

SNC Task uses commons for synchronization (RSX-lLIM-PLUS). 

SPN Task is being suspended. 
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ATL (Cont.) 


SPNA Task was suspended prior to AST. 

STP Task is stopped for terminal input. 

STPA Task was stopped prior to AST. 

WFR Task is in a "wait-for"™ state. 

WFRA Task was in a "wait-for" state prior to AST. 

XHR Task has an external header (RSX-11M-PLUS). 
Format: 


ATL [taskname] 
Example: 


>ATL 
LDR... 112050 LDRPAR 112404 00253100-00255600 PRI - 248. 
STATUS: -CHK FXD STP -PMD PRV NSD 
TI - CoO: I0C - 0. BIO - 0. EFLG - 000001 000000 PS 
PC - 120354 REGS 0-6 120212 010364 177777 107646 074714 
RMDEMO 053550 GEN 046020 01036700-91065600 PRI —- 225. 
STATUS: -CHK WFR -PMD PRV MCR 
TI - TTO: IOC - 0. BIO - 0. EFLG - 000021 040000 PS 
PC - 125234 REGS 0-6 000000 136257 132066 000000 136321 
FI1ACP 111550 GEN 067150 01164600-01230600 PRI - 149. 
STATUS: STP ACP -PMD PRV NSD CAL 
TI - coo: I0C - 0. BIO - 0. EFLG - 000002 000001 PS 
PC - 135244 REGS 0-6 000010 000066 000016 000000 067420 
MCR... 110160 SYSPAR 114514 00202600-00212600 PRI - 160. 
STATUS: STP -PMD PRV MCR CLI NSD CAL 


DPRI - 248. 


- 170000 
107614 120166 
DPRI - 225. 


- 170010 
134560 121166 
DPRI - 149. 


- 170000 
111550 120244 


TI - TT51: IOC - 0. BIO - 0. EFLG - 000001 040000 PS - 170000 


PC - 122436 REGS 0-6 000000 120476 122032 120432 010554 


043552 120366 
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BLK 


BLOCK (NP,P) 


The BLOCK command blocks an installed task. It declares to the system 
that the specified task is not eligible to execute or to compete for 
memory. On multiuser protection systems, nonprivileged users can only 
block active tasks requested from the issuing terminal. Privileged 
users can block any task. On systems without multiuser protection, 
any user can block any task. 


However, the following tasks cannot be blocked: ACP tasks, CLI tasks, 
tasks being aborted, and tasks that are exiting. 


Blocking a task sets the block bit in the Task Control Block (TCB). 
When a task's block bit is set, the task is ineligible to compete for 
system resources. To clear the block bit, issue the MCR UNBLOCK 
command or, if the task is active, abort the task. (Unblocking or 
aborting a task are the only ways to cancel the BLOCK command.) 


A blocked task has an effective priority of 0. If the task is 
checkpointable, any task can checkpoint it. Once checkpointed, the 
blocked task is ineligible for memory contention. A blocked task that 
is then aborted is automatically unblocked by the system. If the task 
had previously specified a requested exit AST, the task is unblocked 
and the AST declared for it. 


Format: 
BLK [taskname] [/TERM=TTnn:] 

taskname 
The name of the task to be blocked. If taskname is not 
specified, the command attempts to block the task requested from 


the issuing terminal (task TTnn). 


reny> TTD 


AM privileged RSX- 11M- =p 
initiated. from Ehe] ‘speci 


specifies a 
blocked. CS RO 


Examples: 


>BLK TST 
locks task TSTT36, prohibiting it from further execution. 
ape is the terminal from which the task was initiate 


BLK . MAS/ TERM= TT: 


“Blocks” “task MAST23. 
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BOO 


BOOT (P) 

The BOOT command bootstraps a system that exists as a task image file 
on a Files-1l volume. It provides a convenient means of terminating 
one system and initiating another, especially on minimum hardware 
configurations. For example, BOOT can be used to terminate a 
real-time system and initiate a program development system. 


The BOOT command immediately terminates the system currently in 
operation. 


Bootable systems are special task image files that have no _ task 
headers. Examples of such systems are RSX-11M and RSX-11S. 


Format: 
BOO[T] [filespec] 
filespec 
The standard RSX-11M/M-PLUS file specification in the form: 
dev: [ufd] filename.type;ver 
This specifies the file from which a new system is to be loaded. 


Defaults applied to the file specification are: 


dev: The system device LB: 

[ufd] The UIC under which BOOT is running 
filename RSX11M 

type SYS 

version The latest version 


Note that BOOT is the only command that allows the file 
specification to omit the file name. 


Table 3-1 lists all of the valid bootable devices for RSX-11M and 
RSX-LIM-PLUS. 


Table 3-1 
Valid Bootable Devices 


RSX-11M RSX-11M-PLUS 


RLO1/02 


RLO1/02 RP02/03 RC25 

RKO5 RP04/05/06 RKO5 RP02/03 
RKO6/07 RS03/04 RK06/07 RP04/05/06 
RM02/03/05/80 | RX01/02 RM02/03/05/80 RD51 

RPO7 RX50 RPO? RX50 

RA60 RD51 RA60 ML11 
RA80/81 DECtape RA80/81 

RC25 MLL 
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Restrictions: 


For a virgin system boot, the boot device physical unit number 
(unit plug) must egual the logical unit number in the virgin 
system. Otherwise, the initial SAVE command line will not work. 


It is not possible to correctly boot a large virgin Executive 
under the following circumstances: 


1. When booting a mapped RSX-11M or RSX-11M-PLUS system 
from an unmapped RSX-11M system 


2. When booting a 22-bit RSX-11M or RSX-11M-PLUS system 
from an 18-bit RSX-11M system 


Booting from an unmapped RSX-11M system: If the Executive being 
booted has anything fixed in memory above 27.5K words (for 
example, drivers, tasks, or commons), it will not be read into 
memory, causing problems when you try to run the system. This 
happens because BOOT moves the bootstrap code in an _ unmapped 
system to the top of memory less .5K (28K - .5K) and can only 
read in the virgin system image up to this location (27.5K). 
Anything above 27.5K is not read in. 


Booting from an 18-bit RSX-11M system: If the system image being 
booted is larger than the running system, not all of the image 
will be read into memory. Again, BOOT only reads in the image up 
to the beginning of the bootstrap code. If the Executive has 
anything fixed in memory above this location, BOOT will not’ read 
it in and the new system will not run properly. 


If the Executive Debugging Tool (XDT) has been generated into the 
system, XDT displays the following when an RSX-11M/M-PLUS system is 
booted for the first time: 


XDT: baselevei 
XDT> 
where baselevel is the base level number for the system. 


Typing the G key in response to the prompt returns controi_ to 
RSX-11M/M-PLUS and causes the system to come up normally. After the 
system has been saved, XDT does not reappear unless a user sets aa 
breakpoint or issues the BRK command, or the system crashes. (See the 
RSX-11M or RSX-11M-PLUS Guide to Writing an I/O Driver for a 
description of XDT.) ae we 
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>BOO TEST 


Bootstraps from the system device the system contained in 
the file TEST.SYS. 


Command Error Messages: 


RAN 
DYUY 


BOO 


BOO 


BOO 


BOO 


BOO 


BOO 


BOO 


ai ee 


The booting system does not contain the data structures 
needed for the device being booted. 


-- DEVICE OFFLINE 

An attempt was made to boot a file on an off-line device. 
-- DPB ERROR 

A bad Directive Parameter Block was created by BOOT. This 
error indicates that the system itself has faulted. If the 
error persists, submit a Software Performance Report (SPR) 
to DIGITAL. 
-- FILE NOT CONTIGUOUS 


An attempt was made to load a system from a noncontiguous 
file. System images must be contiguous. 


-- INVALID LOAD DEVICE 


BOOT detected a device that was invalid as a_ system 
residence device. 


-~- LABEL BLOCK READ ERROR 


An attempt was made to read the label block of the system 
image file, but the attempt failed. 


-- NOT A SYSTEM IMAGE 


BOOT did not consider the file to be a system image file, 
probably because the file is formatted improperly. 


-- NO TRANSFER ADDRESS 
BOOT did not consider the file to be a system image file 


because the specified transfer address in the label block 
appears to be corrupted. 
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BRK 


BREAKPOINT TO EXECUTIVE DEBUGGING TOOL (P) 


The BRK command passes control to the Executive Debugging Tool (XDT) 
if it has been generated into the system. If XDT is not in the 
system, the command has no effect. See the RSX-11M or RSX-d11M-PLUS 
Guide to Writing an I/O Driver for a description of XDT. Note that, 
if successful, the command halts all system activity; proceeding from 
a breakpoint normally restores the system to the state that existed 
when the BRK command was issued. 


When XDT gains control, it prints the message 


BE: nnnnnn 
XDT> 


on the console terminal to indicate that XDT now has control. All XDT 
commands are available for use in debugging the Executive or 
user-written drivers. To return control to MCR, enter the P command; 
MCR then prompts with a right-angle bracket (>). 


Format: 

BRK 
Example: 

>BRK 

BE: 124540 


XDT>P 
> 
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BROADCAST (NP,P) 


The BROADCAST command displays a specified message at one or more 
terminals, as follows: 


e A privileged user can display a message at all terminals 
connected to the system or, in a multiuser protection system, 
at all logged-in terminals. 


e Both privileged and nonprivileged users can display a message 
at any one terminal. 
You can also create an indirect command file to contain one or more 
lines of input to the command. Each line specifies the target 
terminal and the message to be broadcast. (Privileged users can 
broadcast a message simultaneously to all terminals.) To use the 
command file, enter after the command name the file specification 
preceded by an at sign (@). 


If the message cannot be broadcast within 20(10) seconds, the system 
displays the following message at the issuing terminal: 


BRO -- Message failed to reach TTnn: 


If a privileged user specifies multiple terminals (ALL: or LOG:), the 
system returns one error message for each busy terminal. 


If you have used SET /NOBROadcast so that you will not receive any 
messages sent by the BRO command, the user sending the message will 
receive an error message. 
Formats: 

BRO[ADCAST] TTnn: message 

BRO[ADCAST] @filespec 


BRO[ADCAST] ALL:message (Privileged format) 


BRO[ADCAST] LOG:message (Privileged format) 


NOTE 


Each format can be entered on two 
successive lines by pressing the RETURN 
key immediately after the command name; 
this invokes the direct task format. 
For example: 


>BRO[ADCAST] 
BRO>TTnn:message 


To exit from the direct task format, 
type CTRL/Z. 
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TTnn: 
The terminal to receive the broadcast message. 

message 
The message to be broadcast. This is an ASCII character’ string 
that cannot exceed the length of one line (80 characters). Note 
that an exclamation mark (!) cannot be broadcast. 
Usually, BRO uses uppercase letters when it displays the message. 
When you use the direct task format, however, BRO displays the 
message exactly as you typed it. 


filespec 


The specification of a file containing one or more message lines 
in the format: 


TTnn: message 

user-name message 
or, for privileged users: 

ALL:message 


LOG: message 


ALL: 
Privileged option. Indicates that the message is to be sent to 
all terminals connected to the system (this does not include 
slaved terminals, virtual terminals, or terminals that have the 
broadcast option disabled). 

LOG 


Privileged option. Indicates that the message is to be sent to 
all logged-in terminals (this does not include slaved terminals, 
virtual terminals, or terminals that have the broadcast option 
disabled). In a system that does not support multiuser 
protection, LOG: defaults to ALL:. 
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The BRO command displays the message in one of the following formats: 
RSX-11M systems and RSX-11M-PLUS systems without Resource Accounting 


dd:month:yr hh:mm From node::TTnn: to TTnn: 
message 


~ RSX-11M-PLUS systems with Resource Accounting 

chiyr hhimm. From. node: :user-—name. (ttnn:)... to TTnn: 
-dd:month:yr hh:mm From node::user-name. (ttnn:) to user-name 

The variable node is the name that was selected for your system during 

system generation. It is also your DECnet name if your system is on 

the network. 

Examples: 


RSX-11M systems and RSX-11M-PLUS systems without Resource Accounting 


>BRO TT51: PRIVILEGED TESTING. PENDING CRASH. 


displays 

10-AUG-81 13:35 From QUASAR: :TT52: to. TTS5i1% 
PRIVILEGED TESTING. PENDING CRASH, 

>BRO QED 

BRO>TTS1: More testing. Crash likely. 

displays 

10-AUG-81 13:37 From QUASAR: :TT52: to: T7514 


More testing. Crash likely. 


>BRO LOG:System going down in 5 minutes for reboot. 


displays 


10-AUG-81 13:40 From QUASAR: :TT52: to. TTS1: 
SYSTEM GOING DOWN IN 5 MINUTES FOR REBOOT. 
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Note: 


The BROADCAST command uses the write-breakthrough feature of the 
terminal driver, a system generation option always generated with 
an RSX-11M multiuser protection system and all RSX-11M-PLUS 
systems. If the system supports the feature, the broadcast 
message, under most circumstances, reaches all target terminals. 
If the system does not support the write-breakthrough feature, 
the write defaults to a write logical block; the message cannot 
break through any type of I/O at the terminal. 


Command Error Messages: 


BRO -- COMMAND INPUT ERROR 


The BROADCAST task did not receive the command line. 
(Usually an indirect command file could not be found.) 
Reenter the command line. 

BRO -~ COMMAND SYNTAX ERROR 
The command line had an improper format. 

BRO ~-— ILLEGAL DEVICE SPECIFIED 
The specified device was not a terminal. 


BRO -~- MESSAGE FAILED TO REACH TTnn: 


The message could not be displayed within 20(10) seconds at 
the terminal specified by TTnn:. 


BRO -- PRIVILEGED COMMAND 
A nonprivileged user entered a privileged option of the 
command, that is, attempted to broadcast one message to all 
connected or logged-in terminals. 


BRO -- USER NOT RECEIVING MESSAGES 


The terminal to which the message was sent has been 
SET /NOBROadcast. 
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BYE (NP) 


The BYE command logs you out of a multiuser protection system. The 
system writes a logout message on the console terminal (CO:), displays 
a terminating message on the initiating terminal, aborts any active 
nonprivileged and some privileged tasks that belong to you, dismounts 
volumes mounted by you (an exception is when you are a privileged user 
and you have mounted a public device -- mounted public volumes remain 
mounted), and deallocates any private devices you had allocated 
previously. 


Upon logging out a terminal, BYE performs the following actions: 


1. Checks to see if the terminal's current command line 
interpreter (CLI) has requested a silent logout. If so, BYE 
does not display any information and does not execute the 
system logout command file. 


2. If silent logout is not requested, BYE resets the default CLI 
for the terminal to MCR, resets the terminal so that it can 
receive broadcast messages, and executes 
LB: [1,2]SYSLOGOUT.CMD, the system logout command file. 


3. Informs the full-duplex terminal driver or DECnet that the 
terminal is logging out. BYE issues a QIO directive that the 
terminal driver uses to hang up remote lines or that DéECnet 
uses to break the connection. 


This action can be controlled by the /[NO]HOLD keyword. If 
you specify /HOLD, BYE logs out the terminal but the line is 
not hung up. If you specify /NOHOLD, BYE logs out the 
terminal and the line is hung up. (/NOHOLD is the default.) 


The way in which BYE aborts (or does not abort) a task active on the 
terminal being logged out depends on the task and its privilege 
status. 


All tasks with abort ASTs and all nonprivileged tasks that are active 
at your terminal when you issue the BYE command are aborted. If a 
nonprivileged task has requested an exit AST service routine by means 
of a SPECIFY REQUESTED EXIT AST directive (SREAS or SREXS$), BYE allows 
the task to enter this service routine. BYE requests each of these 
tasks to exit (abort), causing the requested exit AST to be entered 
for the task. For all of these nonprivileged tasks, BYE allows a 
user-specified time interval during which the AST can be executed for 
the task. At the end of the time interval, which is specified when 
the BYE task is built (the default is 0 or not to wait at all), if the 
task has not exited or if the AST service routine has not been 
entered, BYE aborts the task normally (a second requested exit AST 
cannot be declared for a nonprivileged task) and also aborts any other 
nonprivileged tasks that are still active. 
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BYE aborts a privileged task that has requested an AST service routine 
in the same way as a nonprivileged task. However, any privileged 
tasks that have not exited by the end of the time interval are not 
necessarily aborted. The task itself must determine if it will be 
aborted or not. Privileged tasks that did not request the AST service 
routine remain active. 


Format: 
BYE [/[-] [NO] HOLD] 
Example: 
>BYE 
Have a Good Evening 
13-May-81 18:47 TT13: is logged off QUASAR 


Depending on the time of day, the system displays "Have a Good 
Morning," "Have a Good Afternoon," or "Have a Good Evening." 


92 MING 


63° SECS. 
So ee 


Command Error Message: 
BYE -- SYNTAX ERROR 


A keyword other than a form of /HOLD (/HO[LD],/NOHO[LD], 
/-HO[LD]) was specified in the command line. 


332 
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CANCEL (NP,P) 


The CANCEL command cancels time-based initiation requests for a task. 
These requests result from a RUNS directive or any of the 
time-synchronized variations of the MCR RUN command and are placed in 
the clock queue. (Note that you must be privileged to use these forms 
of the RUN command.) 


Only a privileged user can issue a CANCEL command for a task not 
initiated from the entering terminal. 


CANCEL does not affect execution of a currently active task. CANCEL 
removes only the time-based schedule requests still in the clock 
queue. 
Format: 
CAN[CEL] taskname 
where taskname is the name of the task. 
Example: 


SCAN XKE 


Cancels all periodic rescheduling and time-based initiation 
requests for task XKE. 
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CLI 


COMMAND LINE INTERPRETER (P,NP) 


The CLI command sets up for use a command line interpreter other’ than 
MCR, such as DCL or ae_euser-written CLI. A CLI task receives 
unsolicited input from a terminal and then attempts to interpret the 
input as a command. On RSX-11M, you can have up to 15 alternate CLIs 
running on your system at one time (the number is selected when the 
system is generated). On RSX-11M-PLUS, the number is always 16, which 
includes MCR. 


Before you use an alternate CLI, it must be installed with the 
/CLI=YES option. (See the description of the INSTALL command.) 


All of the CLI command keywords and subkeywords can be truncated to 
three characters. 


Formats: 

CLI /keyword=cliname 

CLI /INI[(T]=cliname[/subkeyword(s) ] 
cliname 


The name of the alternate CLI. This name can be 1 to 6 
characters in length. 


Keywords: 
/DISABLE=cliname 


Disables the specified CLI. The CLI cannot accept any 
commands. This effectively stops system use by terminals 
set to this CLI until the CLI is enabled again. The system 
sends a message to the CLI informing it that it has been 
disabled if the CLI was initialized with the /MESSAGE 
subkeyword specified. 


/ELIM=cliname or /ELIM=* 


Removes all of the data structures for the specified CLI or, 
if the wildcard (*) is used, for all of the alternate CLIs. 
After this command is executed, the CLI task can be removed 
(see the description of the REMOVE command). 


Individual CLIs can be eliminated only if n terminals are 
set to them. When you use the wildcard option, all CLIs 
except MCR are eliminated. Any terminals set to a non-MCR 
CLI are disabled. The terminals can be enabled again by 
setting them to any valid CLI (after Lt has been 
initialized) or to MCR (which does not need to be 
initialized). CLIs that were initialized with the /MESSAGE 
subkeyword receive a message from the system informing them 
that they have been eliminated. 


/ELIM=* is intended to be used during the system shutdown 
procedure. 
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/ENABLE=cliname 


Enables a previously disabled CLI. The CLI can now accept 
commands. Tf the CLI was initialized with the /MESSAGE 
subkeyword specified, the system sends a message to the CLI 
informing it that it is now enabled. 


While a CLI is disabled, the terminal remains set to it. To 
set the terminal to an enabled CLI, issue the SET /CLI 
command from another terminal (privileged users only). 


/INIT=cliname[/subkeyword(s) ] 


Initializes the data structures for the specified CLI. so 
that terminals can be set to it. The CLI task must have 
been installed with the /CLI=YES option. All cCLIS except 
MCR must be initialized before they can be used. 


If the /MESSAGE subkeyword is specified, the system sends a 
message to the CLI, informing the CLI that it has been 
initialized. 


Subkeywords: 
/CPR="string" 


Specifies the CTRL/C prompt. string. The string 
inside the quotation marks has the same syntax as 
the MACRO-ll .ASCII directive (see the PDP-11 
MACRO-11 Language Reference Manual). You must 
supply characters such as RETURN (<15>) and _ LINE 
FEED (<12>) because they are not supplied 
automatically. For example: 


/CPR="<15><12>/MCR>/" 


sets up the string for MCR's CTRL/C prompt. This 
means that when you type a CTRL/C, the system 
issues a RETURN/LINE FEED and then displays’ the 
prompt MCR>. 


A null string (/CPR="") specifies that no prompt 
will be issued. 


If you want to use double quotation marks or 
slashes within the string, use different 
characters as the string delimiters. (The 
delimiters can be any character that is not used 
in the string.) 


Default: /CPR="<15><12>/cli/" where cli is’ the 
name of the CLI. 
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/ DISABLE 


Initializes the CLI in disabled mode. The system 
rejects any commands issued from the terminal 
until the CLI is enabled. 


Default: The CLI is enabled. 
/DPR="string" 


Specifies the default prompt to be issued when an 
empty command line is entered. As with /CPR, the 
String inside the double quotation marks has_ the 
same syntax as the MACRO-11 .ASCII directive. You 
must supply characters such aS RETURN (<15>) and 
LINE FEED (<12>) because they are not supplied 
automatically. 


A null string (/DPR="") specifies that no prompt 
should be issued. 


If you want to use double quotation marks or 
slashes within the string, use different 
characters as the String delimiters. (The 
delimiters can be any character that is not used 
in the string.) 


Default: /DPR="<15><12>/>/" 
/LGO 


Specifies that the CLI will accept commands’ from 
unlogged-in terminals. This allows the CLI to 
execute the commands without the user having to 
log in. An application can, for example, use the 
terminal for data entry only and not allow it 
access to the system. The terminal is under 
complete control of the CLI task. You can only do 
what the CLI allows. 


Tt is up to the CLI to do any user validation or 
security checks. Also, be careful when doing any 
file I/O from tasks running on an-_ unlogged-in 
terminal because the UIC and privileges for the 
terminal are undefined. 


Default: Commands from unlogged-in terminals will 
be rejected by the system and not passed to the 
CLI. 
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/ MESSAGE 


Specifies that the CLI wants to receive messages 
from the system. The system messages inform the 
CLI of events such as its being enabled or 
disabled, or if a terminal is being set to the CLI 
or if it is being dissociated from the CLI. (See 
the RSX-11M/M-PLUS System Management Guide for a 
list of the messages and their format.) 


Default: The CLI does not receive messages from 
the system. 


/NULL 


Specifies that the CLI will accept empty command 
buffers resulting from a user pressing the RETURN 
key as the first character in a command line. No 
prompt is issued. 


Default: The command is not passed to the CLI and 
the default prompt is issued. 


/PRIV 


Specifies that a user must be privileged to set 
the terminal to the CLI. (See the description of 
the SET command.) 


Default: A nonprivileged user can set his or her 
own terminal to the CLI. 


/ PROMPT 


Specifies that the CLI wants to receive prompt 
requests if a task that was started in order to 
execute a command exits. 


Default: The dispatcher issues a prompt and _ the 
request is not passed to the CLI. 


/QUIET 


Specifies that the MCR commands HELLO and BYE do 
silent logins and logouts, respectively. (See the 
descriptions of these commands.) The keyword also 
suppresses messages from the dispatcher. 
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/RESTRICT 


Specifies that only the CLI can issue the SCLI$ 
directive to set a terminal to itself. (See the 
RSX-11M/M-PLUS Executive Reference Manual.) 


Note that you cannot use /RESTRICT for CLI tasks 
whose names are in the form ...xxx. 


/TASK=taskname 


Specifies the name of the task that will act as 
the CLI. Use this keyword if the name of the task 
is different from the name of the CLI. 


/MESSAGE=cliname: "message-text" 


Sends an ASCII message to the CLI if it has the message 
attribute set for it (by the /MESSAGE subkeyword). If the 
CLI does not have the attribute set, the command issues an 
error message. 


/ SHOW 


(Nonprivileged keyword.) Displays information about each CLI 
on the system. The information includes the name of the 
CLI, the task that implements the CLI, the number of 
terminals set to the CLI, several status bits for the CLI, 
and whether the CLI is active. 


The following list gives the meaning of the status bits: 


ACT CLI is active (always shown for MCR). 
DSB CLI is currently disabled. 
PRV CLI was initialized with the /PRIV subkeyword. 


You must be privileged to set a terminal 
(including “‘TI:) to this: Cit. 


RST CLI was initialized with the /RESTRICT 
subkeyword. Only the CLI can set a terminal to 
itself. 
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/UNOVR 


Clears the override bit set for the terminal's CLI. When 
the HELLO command enters the command file 
LB:[1,2]SYSLOGIN.CMD, the terminal is set to a specific CLI. 
However, an override bit is also set so that the command 
file can execute from MCR. Clearing the override bit 
ensures that commands issued from the terminal will go to 
the correct CLI. 


/UNOVR is only useful with SYSLOGIN.CMD, immediately before 
chaining to a user's LOGIN.CMD, or exiting. 


Examples: 
>CLI /SHOW 
MCR MCR... 9 ACT 
DCL SeabDCk. “O 


Displays information about the CLIs currently installed in 
the system. 


>CLI /INI=TCP/LGO/MES/TASK=PROMPT 


Initializes the task PROMPT as a CLI. The command line 
specifies that the CLI will be called TCP, it will accept 
commands from unlogged-in terminals, and it will receive 
messages from the system. (Note that PROMPT must first be 
installed with the /CLI=YES option before it can be 
initialized as a CLI.) 


Command Error Messages: 


CLI -- CLI ALREADY EXISTS 
You attempted to initialize a CLI that already exists in the 
system. 

CLI -- CLI DOES NOT ACCEPT MESSAGES 


The CLI was not initialized with the /MESSAGE keyword, so 
its message attribute bit has not been set. The CLI is 
unable to receive any messages. 

CLI -- CLI IN USE 


You attempted to eliminate a CLI that still has terminals 
set to it. 


CLI -- DEVICE ATTACHED 


The CLI command cannot do a /SHOW display because another 
task has attached the terminal. 
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CLI 


CLI 


CLI 


CLI 


CLI 


CLI 


CLI 


CLI 


CLI 


CLI 


CLi 


-- FEATURE NOT SUPPORTED 
The system does not support alternate CLIs. 
-- ILLEGAL KEYWORD VALUE 


You specified an invalid string with the /CPR or /DPR 
subkeyword. 


-- ILLEGAL USE OF RESTRICT SWITCH 


A CLI cannot be initialized with /RESTRICT if the name of 
the CLI task is in the form ...xxx. 


-- INVALID KEYWORD 
An incorrect keyword was specified in the command line. 
-- MAX NUMBER OF CLIS ALREADY PRESENT 


You attempted to initialize another CLI, but the maximum 
number of CLIS allowed in the system has already been 
reached. 


-- NO POOL SPACE 


Not enough space in pool is present to do the operation 
specified in the command line. 


-- OUTPUT’ ERROR 


An I/O error occurred while output was being sent to the 
terminal. 


-- PARTITION TOO SMALL TO BUFFER INFORMATION 


The /SHOW subkeyword did not have enough space to buffer the 
display information. Try reinstalling the MCR task with a 
larger increment, using the /INC keyword (see the 
description of the INSTALL command). If the error persists, 
submit a Software Performance Report (SPR). 


-- PRIVILEGED COMMAND 

Nonprivileged users can only use the /SHOW keyword. 
-- SYNTAX ERROR 

The command line was not entered correctly. 


-- TASK NOT A CLI 


You attempted to initialize a CLI task that was not 
installed with the /CLI=YES keyword. 


-- TASK NOT IN SYSTEM 
The specified CLI task has not been installed or you 


attempted to eliminate a CLI whose name is unknown to the 
system. 


MCR COMMANDS 


CLQ 


CLOCK QUEUE (NP) 


The CLOCK QUEUE (CLQ) command displays on the entering terminal 
information about tasks currently in the clock queue. The information 
consists of the task names, the next time each task is to be run, and 
each task's reschedule interval, if one was specified. The system 
places a task in the clock queue if the task was activated by the RUN 
command, which specified a time-based option, or by the RUNS 
directive. 


Format: 
CLO[UEUE] 
Example: 


>CLO 

TASK1 Scheduled at 22-APR-81 10:24:30:00 

TASK2 Scheduled at 22-APR-81 10:30:00:00 Reschedule interval 30M 
> 


The first task in the queue will run at 10:24:30:00 (hour: 
minute: second: clock tick); it has not been rescheduled. 
The second task in the queue will next run at 10:30:00:00 
and is scheduled to run every 30 minutes. 
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DIGITAL COMMAND LANGUAGE (NP) 
The DCL command allows you to issue DCL commands from a terminal that 
is set to MCR. Instead of MCR processing the command line, DCL 
processes it. The DCL task must be installed before it can do command 
processing. See the RSX-11M/M-PLUS Command Language Manual _ for 
descriptions of the DCL commands. 
Format: 

DCL command-line 
Examples: 


>DCL SET DEF LB: 


Issues the DCL command that sets the default device for’ the 
entering terminal to be LB: (the system device). 


>DCL TYPE [303,24]USERS.TXT 


Issues the DCL command that displays a file on the entering 
terminal. The file is USERS.TXT, which is in UFD [303,24]. 
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DEALLOCATE (NP,P) 


The DEALLOCATE command releases a private (allocated) device, thereby 
allowing other users to access it. (This command applies only to 
systems that support multiuser protection.) Nonprivileged users can 
only deallocate private devices that they themselves have allocated. 


A privileged user can deallocate any device in the system. 


Note that when an owner of a private device logs out (issues the BYE 
command), the system deallocates all that user's private devices. 
However, if the system detects an error while attempting to deallocate 
a device, it stops and does not deallocate that device or any 
remaining devices. The related error message does not state which 
device caused the error. 


If an allocated device has been mounted, it must be dismounted before 
you deallocate the device. 


Format: 
DEA[LLOCATE] [ddnn:] 

ddnn: 
The device-unit name and number of the private device to be 
deallocated. If the command line does not specify a device unit, 
the system deallocates all private devices owned by the user 
logged in on the issuing terminal. 

Example: 


>DEA DM: 


Deallocates disk DM:. The deallocated device can now be 
mounted or allocated by other users. 
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DEV 


DEVICES (NP,P) 


The DEVICES command displays the symbolic names of all devices or all 
of a particular device type or the name of a specific device. The 
device names appear in one column; second and subsequent columns 
contain additional information about each device. 


Formats: 


DEV[ICES] 
DEV[ICES] dd: 
DEV[ICES] ddnn: 
DEV[ICES] /LOG 


dd: 
The type of devices for which you want the information to be 
displayed. 
ddnn: 
The specific device for which you want the information to be 
displayed. 
/LOG 
Displays all logged-in terminals. 
On RSX terminal or /LOG, the 
displa S. Also, if Resource 


Accounting is running, t the date and time of 
ces : : : . first initial and 


Examples: 


RSX-11M systems 


>DEV 

DBO: Public Mounted Loaded Type=RP06 
DB1l: Public Mounted Loaded Nowrite Type=RP05 
DB2: Public Mounted Loaded Type=RP05 
DB3: TT60: - Private Loaded Type=RP05 
DB5: Offline Loaded Type=RP05 

DMO: Loaded Nowrite Type=RK06 

DM1: TT60: -— Private Loaded Type=RK06 
DRO: Offline Loaded Type=RM03 

DRI: Loaded Type=RM03 

LPO: Public Loaded 

MMO: TT60: - Private Loaded 

MM1: TT10: - Private Loaded 

TTO: Loaded 

TTl: Loaded 

TT2: {312,1] - Logged On Loaded 

TiS Loaded 

TT4: ([302,310] - Logged on Loaded 
TTS: Loaded 
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TT6: [306,14] - Logged On Loaded 

TT7: [50,25] - Logged On Loaded 

TT10: [306,50] - Logged On Loaded 

coo: Loaded 

NLO: 

TIO: 

CLO: LPO: 

LBO: DBO: 

SYO: DBO: 

> 

>DEV /LOG 

TT2: {312,1] 

TT4: {302,310] 

TT6: [306,14] 

TT7: [7,25] 

TT10: [306,50] 

> 

>DEV DBI: 

DB1: Public Mounted Loaded Nowrite Type=RP05 

> 

>DEV TT30: 

TT30: [7,30] [7,30] 
CLI = MCR BUF = 80. HFILL = 
LINES = 24. TERM = VT52 OWNER = 
LOWER PRIV NOHOLD NOSLAVE NOESC 
ECHO NOVFILL HHT NOFDX WRAP 


RSX-11M-PLUS systems 
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0 SPEED= (9600: 9600) 
NONE BRO NOABAUD 
CRT NOFORM NOREMOTE 
NORPA NOEBC TYPEAHEAD 


>DEV DB: (if privileged) 
DBO: Offline Loaded Type=unknown 
DB1: Offline Loaded Type=unknown 
DB2: Mounted Loaded Label=DEVUTIL Type=RP05 
DB3: Public mounted Loaded Label=USERS1 Type=RP06 
> 
>DEV TT23: 
TT23% [7,20] [7,20] 2-FEB-81 10:20 0 J. WHITE 
CLI = MCR BUF = 80. HFILL = 0 SPEED= (9600: 9600) 
LINES = 24. TERM = VT100 OWNER = NONE BRO NOABAUD 
LOWER PRIV NOHOLD NOSLAVE NOESC CRT NOFORM NOREMOTE 
ECHO NOVFILL HHT NOFDX WRAP NORPA NOEBC TYPEAHEAD 
> 
>DEV /LOG 
TRI ks {304,6] [7,306] 2-FEB-81 08:28 1 R. SMITH 
TT12: [7,25] [77251 2-FEB-81 08:42 1 M. BROWN 
TTS: [7,201] (7,201] 2-FEB-81 10:24 1 J. STORM 
Tos [75325] 75325] 2-FEB-81 08:08 0 P. JONES 
Notes: 
appear in the 


The following notes describe the information that can 


subsequent columns. 


MOUNTED indicates that the device is mounted. If a privileged 
user issues the command, the display includes the volume 
label. 


PUBLIC indicates that the device has been set public. 
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e NOWRITE indicates that the volume is software write-locked 
(write operations are not allowed on the volume). 


e TYPE indicates the device type. 
e MARKED FOR DISMOUNT indicates that a mountable device has been 


requested to be dismounted, but the dismount operation has not 
yet been completed. 


e OFFLINE indicates that, although the system tables contain 
entries for this device, the host configuration does not 
contain the related device, or the device was powered down at 
the time of the boot. 


e {uic] LOGGED ON indicates that the user identified by  [uic] 
(the protection UIC) has logged in on the terminal. 


e LOADED indicates that a loadable device driver is currently 
loaded. 


e UNLOADED indicates that a loadable device driver is currently 
not loaded. 


e A device name in the second column is the device to which the 
corresponding device in the first column has been redirected. 


e A terminal name in the second column followed by the text 
"— PRIVATE" indicates that the device named in the first 
column has been allocated to the user logged in on _ the 
terminal in the second column. 


e The lines in the display for a specific terminal list the 
characteristics that have been set for the terminal. The 
description of the SET command gives all of the available 
characteristics. 
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DISMOUNT (NP,P) 


The DISMOUNT command requests the file system to mark the volume _ for 
dismount and release the control blocks. Marking a volume for 
dismount prevents programs from opening additional files on the 
volume. After all files open on the volume are closed, the Ancillary 
Control Processor (ACP) releases the control blocks and dismounts' the 
volume. 


If a single user has mounted a volume, the DISMOUNT command declares 
the volume logically off line. If multiple users have mounted a 
volume, the volume remains accessible until all users have dismounted 
Les 


When you dismount a volume, the DISMOUNT command prints on-_ your 
terminal a message about whether or not a final dismount has been 
initiated. When the dismount operation completes, either through the 
Files-11 disk system or the ANSI magnetic tape system (ANSI 
X3.27-1978), the command prints on the console terminal (CO:) the 
message: 


*** ddnn: DISMOUNT COMPLETE 


NOTE 


Do not remove the volume until after you 
have received this message. If you 
remove the volume beforehand, it might 
be corrupted and the next volume placed 
on the device drive will probably become 
corrupted. 


There may be a considerable delay between the time you issue _ the 
command and the printing of this message if a number of I/0 requests 
are pending and/or a number of files are open on the volume, 


Nonprivileged users can only dismount volumes that they have mounted. 
A privileged user can dismount any mounted volume. 


Formats: 
>DMO ddnn: f["]label["]] [/keyword(s) ] 


>DMO /USER [/keyword(s) ] 
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ddnn: 


label 


The device unit that holds the volume to be dismounted. 


The Files-11 volume label may be up to 12(10) characters in 
length for disk and DECtape, and up to. six characters for 
magnetic tape. It is used to verify that the proper volume is 
being dismounted. A volume label is optional (if the command 
omits a label, no volume label check is performed). 


If a volume label for a magnetic tape contains special 
characters, it must be enclosed in quotation marks. See the 
description of the MOUNT command for the list of special 
characters. 


Keywords: 
/DEV 
(Privileged keyword.) Dismounts all users from a_e specific 
device. This keyword must be specified if you are 
dismounting a public device. 
/USER 


Dismounts all volumes that a user has mounted. 
/TERM=ttnn: 


(Privileged keyword.) Dismounts all volumes that a user at 
the specified terminal has mounted. 


/LOCK=option 


Allows logical I/O to a volume after it is dismounted. ciga 
the drive supports software spin-down, you can also specify 
whether or not the disk should be left spinning after the 
dismount. For magnetic tapes, /LOCK can be used to dismount 
and remount a tape without having to reload the tape. 


The options for the /LOCK keyword are: 


/LOCK=Nounload 
/LOCK=Unload 
/LOCK=Virtual 


When you specify the Nounload option (/LOCK=N), DISMOUNT 
clears the volume valid bit and does not spin down the disk 
or unload the tape. This option only inhibits access to the 
volume. This option is the default lock value for volumes 
mounted as foreign and with no ACP specified. (See the 
description of the MOUNT command.) 
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When you specify the Unload option (/LOCK=U) for disks, 
DISMOUNT clears the volume valid bit and, if the drive 
supports the spin-down function, spins down the disk. When 
you specify /LOCK=U for tapes, DISMOUNT rewinds and unloads 
the tape. Depending on the hardware, this may only place 
the unit off line at load point or it may completely unload 
the tape and close the autoload tape ring. The /LOCK=U 
option is the default lock value for all volumes mounted 
with a standard ACP. The usual procedure after dismounting 
a volume that uses a standard ACP is to remove the volume 
from the drive. 


The Virtual option is privileged. When you specify /LOCK=V, 
DISMOUNT does not clear the volume valid bit and does not 
spin down the disk or unload the tape. The Executive still 
permits logical I/0 to the volume. For example, the task 
image of an installed task can reside on a disk that has 
been dismounted with the /LOCK=V option. However, the file 
system cannot access the volume. This option is the default 
when dismounting the system disk prior to saving the system. 


Examples: 
>DMO DM1:AMBER 


Dismounts the volume labeled AMBER on device unit DMl:. If 
a Single user has mounted the volume, the command dismounts 
the volume. If more than one user has mounted the volume, 
the volume remains mounted for the other users. 


>DMO DM1:/DEV 
Places the volume on device unit DML: logically off line 
and releases all control blocks. Users can no longer access 
the device. 

>DMO /USER/TERM=TT17: 


Dismounts all volumes mounted by terminal TT17:. 


>DMO DKO: 
DMO -- TT60: dismounted from DKO: *** Final dismount initiated *** 


Begins the dismounting process for DKO:. When the DISMOUNT 


COMPLETE message is printed on the console terminal, the 
volume can be removed from the drive. 
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Command Error Messages: 


DMO -- WARNING -- TASKS INSTALLED FROM ddnn: 


The disk being dismounted has tasks installed from it. DMO 
dismounts the disk, but you can still run the tasks until 
the disk has spun down. Use the TAS command to find out 
which tasks are installed. 


DMO -- CHECKPOINT FILE STILL ACTIVE 


The command attempted to dismount a volume that contained an 
active checkpoint file. The volume cannot be dismounted 
until the checkpoint file has been discontinued. Issue an 
ACS command to discontinue the file and reissue the DMO 
command when the system issues a message to indicate that 
the checkpoint file is inactive. 


DMO -- DISMOUNTING SYSTEM DISK 


This message should only occur during a system generation or 
during system shutdown. Since the system disk is a public 
device, it can be dismounted only by a privileged user. 


DMO -- DISMOUNT IS NOT NECESSARY FOR CASSETTES 
Self-explanatory. This is an informational message only. 
ddnn: IS ATTACHED BY TASK taskname 
DMO attempted to dismount an attached device. Because DMO 
processes the moun list several times before exiting, a 
device could be dismounted if the task to which it belongs 


detaches before DMO exits. If the device is dismounted, a 
normal dismount message appears later. 
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-- NO VOLUME LIST 


The command specified a magnetic tape for which a mounted 
volume label list does not exist. 


MANY DEVICES ATTACHED, NO FURTHER ATTACH MESSAGES 
DMO issues this message when eight (or more) devices are 
attached during a DMO /USER operation. A message is printed 
for the eighth device, but not for any number over that. 
-- VOLUME NOT MOUNTED 
The specified device was not mounted. 
-- VOLUME NOT MOUNTED BY TI: 
The command specified a dismount operation for a volume that 
was not mounted from the issuing terminal or the command 
specified the wrong device name for a tape set. 


-- WRONG VOLUME LABEL 


The volume label and the label specified in the command did 
not match. 
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FIX-IN-MEMORY (P) 


The FIX command loads and locks a task into its partition. Subsequent 
requests for running the task are serviced more quickly because the 
task is memory-resident and does not have to be loaded from the disk 
before it can run. The system can fix a task in memory only when the 
partition in which it is to be fixed becomes available. 


Fixed tasks remain physically in memory even after they exit. 
Therefore, they do not have to be reloaded when a request is made to 
run them. (Note that reexecuting fixed tasks is not always practical; 
to reexecute, the task must initialize all impure data and LUN 
assignments at run time.) Only an UNFIX or REMOVE command can free the 
occupied memory partition. 


The following restrictions apply to the fixing of tasks: 


@e On RSX-11M systems, checkpointable tasks cannot be fixed. On 
RSX-11M-PLUS systems, checkpointable tasks should not be fixed 
because fixing a checkpointable task makes the task 
noncheckpointable. 


e Active tasks cannot be fixed. 


e A task must be installed before it can be fixed. 


Format: 
FIX taskname[/keyword] 


The variable taskname is the name of the task to be fixed in 
memory. 


When fixin st nt of am tee Bec 
yeu must = ltio user task. ay 
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Examples: 


>FIX XKE 


Fixes task XKE in its partition. 


Command Error Messages: 
FIX -- PARTITION BUSY 


The partition in which the task was to be fixed was 
occupied, so the task could not be fixed. 


FIX -- TASK ACTIVE 
The specified task is already active. Active tasks cannot 
be fixed. 

FIX -- TASK ALREADY FIXED 


The specified task was already fixed in memory. 
FIX ~- TASK BEING FIXED 
The specified task was already being fixed. 


FIX -- TASK HAS NO READ ONLY SEGMENT 


An attempt was made to fix the read-only segment of a 
multiuser task, but the spcified task does not have a 
read-only segment. 


FIX -- TASK NOT IN SYSTEM 


The specified task has not been installed in the system. An 
uninstalled task cannot be £f d 
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GROUP GLOBAL EVENT FLAGS (NP,P) 


The FLA command creates, eliminates, or displays group global event 
flags. Group global event flags provide each UIC group with 32 event 
flags in addition to the 32 common and 32 local event flags. Group 
global event flags are similar in use to the common event flags (See 
the RSX-11M/M-PLUS Executive Reference Manual). However, only those 
tasks running under the same group UIC can use the group global event 
flags for that group. 


Nonprivileged users can only create or eliminate group global event 
flags for their login group UIC. 


Privileged users can create or eliminate group global event flags for 
any group. 


Format: 
>FLA[GS] [ggg] /keyword] 


[ggg] 


Represents the group for which the group global event flags are 
to be created; defaults to login UIC group. 


Keywords: 
/CRE 
Creates group global event flags for the specified UIC 
group. If the flags already exist but are marked for 
delete, the delete flag is cleared. 
/ELIM 


Eliminates group global event flags for the specified UIC 
group. Event flags are not eliminated until the access 
count reaches 0. If the access count is greater than 0, the 
flags are marked for delete. 


When you omit the group number and keyword specification, the command 
displays all the group global event flags in the form: 


ggg access count event flags [DEL] 
where [DEL] indicates group global event flags marked for delete. 
Examples: 
>FLA 303/CRE 
Creates group global event flags for all tasks running under 


the UIC group number 303. All flags are initialized to 0 
when created. 
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>FLA 
303 1 000010 000000 


Displays the access count (1) and event flags set (in this 
case, flag 68) for the UIC group 303. The access count is 
the number of tasks using the event flags. 


The group global event flags are represented by two octal 
words. The first word contains event flags 65 through 80 
(from right to left) and the second word contains event 
flags 81 through 96 (from right to left). 


>FLA 303/ELIM 


Eliminates group global event flags for UIC group 303. 


Command Error Message: 
FLA -- ILLEGAL FUNCTION 


The /CRE keyword was specified, but the event flags already 
existed (even though they may have been marked for delete), 
or the /ELIM keyword was specified, but the event flags were 
already eliminated or marked for delete. 


MCR COMMANDS 
HEL/LOG 


HELLO or LOGIN (NP) 


The HELLO and LOGIN commands log you in on a terminal to gain access 
to a multiuser protection system. Before you log in, the system 
rejects all MCR commands except HELLO, LOGIN, and HELP. Parameters to 
the HELLO command are a last name or User Identification Code (UIC) 
and a password. The system validates these parameters according to 
entries in an account file. 

Tf the name or UIC and password mat nentry in the account file, 
the system performs the following a 


1. Checks to see if the terminal's current command line 
interpreter (CLI) has requested a silent login. (Silent 
logins are available only on systems with multi-CLI support.) 
If so, HELLO does not display the login text file or the 
user's login command file, does not execute the system login 
command file, and does not set the default CLI for the 
terminal. 


2. Assigns the login logical device name SyY0: to the user's 
system disk unless the user's logical system device is 
already the same as physical device SY:. (The system disk is 
the one that contains the user's files.) 


3. Establishes the user's login UIC, which is the initial 
default UIC. 


4. Records the current time and date and other information about 
the terminal session in the system file. 


6. Displays a system identification, the current date, and _ the 
time the user logged in on the terminal. If the CLI requests 
silent login, the information is not displayed. 


7. j..I£€ the system supports alternate CLIs, sets the terminal's 
default CLI to be the one specified in the user's account 
file. 


8. Displays the contents of the file LB:[1,2]LOGIN.TXT. If the 
CLI requests a silent login, LOGIN.TXT is not displayed. 


9. Executes the system command file LB:[{1,2]SYSLOGIN.CMD (if it 
exists) unless the CLI requests a silent login. Before the 
file is invoked, HELLO instructs the system to override the 
user's default CLI and use MCR to process the file. (This 
allows SYSLOGIN.CMD to use MCR commands.) SYSLOGIN.CMD is 
invoked with the terminal privileged and slaved. 
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HELLO passes the following information to SYSLOGIN.CMD: 


Default system device (xxn:) 
Login UIC ((g,m] ) 
Last name 

First initial 

If terminal is to be privileged (P or NP) 
If terminal is to be slaved (S or NS) 


If SYSLOGIN.CMD exists, it must do the following: 


e Check the appropriate parameter to see if the 
terminal should be privileged or nonprivileged and 
set the terminal accordingly and then check the 
appropriate parameter to see if the terminal should 
be slaved or nonslaved_ and set the terminal 
accordingly. 


NOTE 


It is important to set a terminal's privilege 
status before its slave status. Otherwise, a 
nonprivileged user could become privileged. 


e If your system has multi-CLI Support, issue the 
command CLI /UNOVR to instruct the system to use the 
user's CLI. The CLI would be MCR, DCL, or a 
user-written CLI. 


If a default CLI is not specified in the account 
file, the terminal is set to MCR. If the specified 
CLI is not present in the system, HELLO issues an 
error message and the user cannot log in. 


The following code is an example of a system command file 
(using Indirect): 


- ENABLE SUBSTITUTION 
- ENABLE QUIET 
-IF PS = "Pp" .GOTO SLAV 
SET /NOPRIV=TI: 

-SLAV: .IF P6 = "S" .GOTO OVER 
SET /NOSLAVE=TI: 


OVER: CLI /UNOVR 
-DISABLE QUIET 
-SETS FILE P1+P2+"LOGIN.CMD" 
-TESTFILE 'FILE' 
IF <FILERR> = 1 .CHAIN 'FILE'/LO 
~ END: 
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10. If LB:[{1,2]SYSLOGIN.CMD does not exist, HELLO executes’ the 
user's LOGIN.CMD if it exists. Before executing, HELLO sets 
the user's slaved or nonslaved and privileged Or 
nonprivileged status and clears the CLI override bit. 


11. After invoking HELLO, if the user does not enter a name or 
UIC and password, HELLO prompts for them. If the user does 
not respond to the prompt within a certain time interval, 
HELLO times out. The timeout interval is specified when the 
HELLO task is built. If the intervai is zero (0), HELLO does 
not time out. 


If logins have been disabled for your system, HELLO displays the 
reason for this. If desired, the person who disables logins can 
create or edit LB:[{1,2]NOLOGIN.TXT to include the reason. 


Formats: 


In the following command formats, the braces indicate that the user 
enters one of the two parameters. 


@ >HEL [LO] ie /password RED 
username 
@ >HEL[LO] 
Account or name: uic RET 
username 


Password: password (te) 


@ >HEL[LO] uic \ RET 
username 
Password: password Re? 
uic 
Your User Identification Code (UIC). The command allows’ the 
following four UIC representations: 
gr7m 
[g,m] 
g/m 
[g/m] 
To Suppress part of the display of the file LOGIN.TXT, use _ the 
slash form (that is, g/m or [g/m]). 
The variables g and m are octal numbers from 1 through 377 that 
represent group and member numbers, respectively. 
username 


Your last name, which can be entered in place of a UIC. 
password 


An alphanumeric password. If type the password in response 
to the prompt PASSWORD:, the system does not display (echo) the 


typed characters. 


raAannAnas 
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If the HELLO command was successful, the system displays the following 
message: 


system i.d. 
dd-mm-yy hh:mm Logged on Terminal TTnn: as xXxnnnn 


greeting 
{login-text] 
system i.d. 
One of the following, depending on the system: 
RSX-11M Binn {[9g,mj System nodename 


RSX-11M-PLUS V0O2 BLnn [g,m] System nodename 
The current date, 


The time the user logged in. 


greeting 


One of the following, depending on the time of day: 


Good Morning 
Good Afternoon 
Good Evening 


login-text 


The contents of LOGIN.TXT (or BATCH.TXT). The system displays 
the contents of the file as follows: 


e If you use the slash form when specifying the UIC the first 
time you log in, the display concludes at the first percent 
sign (%) in the file. Subsequent logins on any one day (using 
the slash form) do not display the contents of the text file 
unless the file has been edited. (The percent sign is used to 
separate new messages from .old ones.) 


e If you do not use the slash form, the system displays the 
entire file. (Note that you can type CTRL/O to end the 
display after the first percent sign.) 

If the login text file does not exist, the message 


MESSAGE FILE ERROR -26 


is displayed. 
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Examples: 


RSX-11M systems 


>HEL 

Account or name: AMBER 

Password: : 

RSX-11M BL32 [4,54] System QUASAR 


2-FEB-81 10:03 Logged on Terminal TT20: 
Good Morning 
2-FEB-81 


*** NEW DISK CONFIGURATION *** 
DBO: System and User disk 


(User typed CTRL/O to stop output.) 


>HEL [301/365] /BOB 


RSX-11M BL32 [4,54] System 
2-FEB-81 10:06 Logged on Terminal TT20: 


Good Morning 


>HEL 301/365 
PASSWORD: 


RSX-11M BL32 [4,54] System 
3-FEB-81 09:45 Logged on Terminal TT17: 


Good Morning 


> 


>HEL 301,365 /BOB 


RSX-11M BL32 [4,54] System 
3-FEB-81 09:45 Logged on Terminal TT17: 


Good Morning 
2-FEB-81 


*** NEW DISK CONFIGURATION *** 


(User typed CTRL/O to stop output.) 
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RSX-11M-PLUS systems 
>HEL 303/24/79584 


RSX-11M-PLUS V0O2 BL10 [2,54] System CASTOR 
02-FEB-81 17:58 Logged on Terminal TT30: as WRT17 


Good Afternoon 
> 


>HEL 303,24 
PASSWORD: 


RSX-11M-PLUS VO0O2 BL10 [2,54] System CASTOR 
02-FEB-81 18:01 Logged on Terminal TT30: as WRT17 


Good Evening 
30-JAN-81 
Batch 
(User typed CTRL/O to stop output.) 
> 
Command Error Messages: 


Note that if you use the LOGIN command to log in instead of HELLO, the 
error messages are preceded by LOG. 


HEL -- ACCOUNT FILE OPEN FAILURE 
The account file was open for another user or the disk 


containing the account file was not mounted. Reenter the 
command line. 


| = ACCOUNT FILE Ri 


40 could “not access an 


HEL -- ASSIGN FAILURE 


HELLO could not assign your system device. 
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~- CANNOT FIND PHYSICAL LB: 
HELLO could not open the file because LB: was not assigned. 
-- CANNOT SET CLI 


(Multi-CLI systems only.) The command line interpreter (CLI) 
is installed in the system, but HELLO failed to set the 
terminal to the citi. 


-- CLI NOT IN SYSTEM 


{Multi-CLI systems only.} You could not log in because the 
default CLI specified for you in the account file is not 
installed in the system. 


-- INVALID ACCOUNT 


The name or UIC specified in the command is not stored in 
the account file or the password specified does not match 
the name or UIC given. 


-- LOGINS ARE DISABLED 

The system was in the process of shutting down or the 
command SET /NOLOGON has been issued. You cannot log in at 
these times. 


-- LOW POOL - NONPRIVILEGED LOGINS DISABLED 


To save space in pool, the system will not allow 
nonprivileged users to log in. 


-- MESSAGE FILE ERROR nnn. 


The system could not open the file LOGIN.TXT for a _ reason 
indicated by the FCS code nnn. See the IAS/RSX-11 I/0 
Operations Reference Manual for a definition of the FCS 
code. 


-- OTHER USER LOGGED ON 
Another user was currently logged in on the issuing 
terminal. Only one user at atime can be logged in ona 


terminal. 
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HEL 


HEL 


HEL 


HEL 


HEL 


-- SPAWN FAILURE 

The Executive directive SPAWN failed to assign your’ system 
device or the Executive directive RPOI failed to chain to 
Indirect to execute the login command file. 
-- SYNTAX ERROR 

The format of the command line for HELLO was incorrect. 


-- TERMINAL ALLOCATED TO OTHER USER 


The issuing terminal was already allocated to another’ user. 
You cannot iog in on a terminal allocated to someone else. 


-- TIMEOUT ON RESPONSE 

You did not respond to the HELLO prompt before the timeout 
count elapsed. (The timeout count is specified when the 
HELLO task is built.) 

-- WARNING ** DEFAULT DEVICE NOT IN SYSTEM 

Your default system device is not in the system, so HELLO 


did not make the assignment. However, you are still logged 
ins 
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HELP (NP) 


The HELP command displays the contents of the general help file for 
your system. The default help file is LB:[{1,2]MCR.HLP. HELP is the 
only MCR command that you can issue without logging in. The display 
usually contains information on how to log in on the terminal, but 
each installation can change the contents of its help file to suit 
specific needs. 


Formats: 
HELP % [qualifierl] [qualifier2] [...qualifier9] 


HELP[/keyword] [qualifierl] [qualifier2] [...qualifier9] 


oe 


Displays the text contained in [current-uic] HELP.HLP. You must 
be logged in to request HELP %. 


Keywords (all mutually exclusive): 
/CLI:cliname 


Directs HELP to the help file for a command line interpreter 
(CLI) in LB:[{1,2]cliname.HLP. 


Tf you are in your own CLI and omit the keyword, the default 
help file is LB:[{1,2]MCR.HLP. 


/DCL 


Specifies that the help text begins in the file 
LB: [1,2]DCL.HLP. This is the default for terminals set to 
DCL. 


/FIL: [filespec}] 


Specifies any file where help text is located. If you do 
not give a complete file specification, the defaults are 
LB:{1,2]filename.HLP. If you only use /FIL:, the default 
help file is LB:[1,2]MCR.HLP. 


/GRO 
Instructs HELP to use [group,1]HELP.HLP on the default 
volume as the root help file. Group help files allow users 
with the same group number to share common help files for 
that group. 

/LOC 


Displays the text contained in HELP.HLP in the default 
directory on the default volume. This keyword is equivalent 
to the HELP % command. 
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/MCR 
Specifies that the help text begins in the file 
LB: [{1,2]MCR.HLP. This is the default for terminals set to 
MCR. 

/OUT:filespec 
Saves the text of the help file (or files) in the specified 
file. If you do not specify a file, HELP puts the help text 
in a file named .;1. If you do not use the /OUT keyword, 
HELP displays the files on your terminal. 

{XXX 


Specifies that the help text begins in the file 
LB:[1,2]xxx.HLP, where xxx is the name of a CLI. This 
keyword produces the same results as specifying /CLI:xxx. 


The format of a HELP.HLP file is: 


1 FIRST-QUALIFIER-1 
Text that will be displayed if you type HELP 
FIRST-QUALIFIER-1. 


2 FIRST-QUALIFIER-2 
Text that will be displayed if you type HELP FIRST-QUALIFIER-1 
FIRST-QUALIFIER-2. 


2 SECOND-QUALIFIER-2 
Text that will be displayed if you type HELP FIRST-QUALIFIER-1 
SECOND-QUALIFIER-2. 


1 SECOND-QUALIFIER-1 
Text that will be displayed it you type HELP 
SECOND-QUALIFIER-1. 


The numerals are level numbers and range from one through nine 
inclusive. Level numbers must be the first character of their line 
and the qualifiers that follow must be uppercase. Arbitrary strings 
of blanks or tabs are allowed between level numbers and qualifiers. 
If a qualifier begins with a dollar sign ($) or a slash (/), the $ or 
/ is ignored. 


HELP interprets its command line in a strictly nested fashion. When 
searching for qualifiers in a help file, HELP begins by iooking for a 
line containing level number 1, followed by the first qualifier 
specified in the command line. If successful and no other qualifiers 
were specified, the subsequent help text is displayed. Otherwise, the 
search continues for a line containing level number 2, followed by the 
second qualifier specified in the command line. Again, if no_ other 
quaiifiers were specified, the subsequent help text is displayed. 
This correspondence of qualifier position in the HELP command line 
with level numbers in the help file continues until the last qualifier 
is found. 
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HELP permits references within the help file to other files that 
contain large blocks of text and/or additional level numbers and their 
qualifiers. Indirect references to other files decreases search time 
and also allows more flexible use of the help file. To reference 
another file from within the help file, specify an at sign (@) as the 
first nonblank character on a line followed by a file specification. 
For example: 


@filespec 


The variable filespec is any legal RSX-11M/M-PLUS file specification. 
The default file type is .HLP. However, if a file type other than 
-HLP is specified, HELP uses the specified file type as the default in 


succeeding indirect references. For example, if you specify 
@filename.TXT, HELP uses .TXT as the default file type in future 
indirect references. The file version number always defaults to the 


highest existing version. 


The file referenced in this manner has the same format as the help 
file. Notes that if the indirect file contains level numbers, the 
level numbers must be greater than the level number in the help file 
that precedes the call to the indirect file. For example, if the help 
file contains the following lines: 


1 EXAMPLE 
@HELPEXAMPLE 


then HELPEXAMPLE.HLP can only contain level numbers greater than 1 
(the numerais 2 through 9), 


HELP also allows you to share text between two or more similar or 
Ssynonomous qualifiers in the help file. To do this, specify a pound 
sign (#) followed by the similar qualifier as the first nonblank 
character ona line. For example, to relate the qualifiers LOGIN and 
HELLO, the help file would contain the following lines: 


1 LOGIN 
#HELLO 
1 HELLO 


See Ben Smith for an account and password. 


Note that the qualifier that contains the displayed text must be of 
the same level number as all the qualifiers that refer to it. Also, 
since HELP searches the help file sequentially, the qualifier must 
appear after all those that refer to it. 


Along with one-word synonyms, you can also use string synonyms. For 
example: 


L UTILITIES 
2 RUNNING 
= TASKS EXECUTING 
1 TASKS 
2 EXECUTING 


Always begin the string synonym with qualifier l. 
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Example: 


The following is an example of a help file: 


The general form of the HELP command is? 

HELF Ceualifieri) Ceuslifier2] [C..-gualifier?] 
This disrlays text from the system hele file, 
The other general form of the HELP command isi 

HELP “2 Ceuslifiert] Caualifier2] C..-aualifier?] 


This disrlays information from 3 user’s own hele file. 
sunmtsx is not lesgsl until vou are lossed in, 


1 LOGIN 
#HELLO 
1 SPELLING 


Tere HELP SPELLING DICTIONARY followed bye the 
gou went to srell,. 
2 DICTIONARY 


The file BICTIONARY.HLF (Cnot included in 


This 


word 


this 


exasmrle] contains an abridged listing of freauently 


missrelled words, 


@DICTIONARY 
1 HELLO 


See Ben Johnson for en account and rassword, 
i CREATE 


NOTE 


When creating 32 hele filer the first line 


should be blank since it is nat disrlaved,. 


By conventions each line should begin with 3 blank 


or 


tab: the lines cannot begin with the digits 1 through 
9 since these would be interpreted as level numbers, 


Also,» derending uwuron the tyres of devices in 


confisgurstion:s some practical restrictions should 


your 
be 


imposed, For examrle,y to accommodate VTOSEs: lines of 


text should not be more than 72(10) characters lomns 


and 


3a block of text should not be more than 20¢10) lines. 


If there are level mti aualifiers: they should 


mentioned in the text so that thes sre known to e 
Similarly: level 1 aualifiers should be added to 
text disrlagyed when only HELP is tured, 


be 


wat a+ 
Pe Oe Y 


the 
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If a system contained this help file, you would get the following 
display in response to HELP L: 


>HELP L 


> 


See Ben Johnson for an account and password. 


The qualifier HELLO is the synonym defined for LOGIN (L), so HELP 


displays 


the text following HELLO for both qualifiers. (Note that a 


qualifier may be specified by the fewest initial characters’ that 
unambiguously define it.) 


Command Error Messages: 


HEL 


HEL 


HEL 


HEL 


HEL 


HEL 


HEL 


-- AMBIGUOUS HELP QUALIFIER 
The qualifier does not specify a unique part of the help 
File. Further characters must be supplied. Examine the 
command line that HELP displayed below the error message and 
specify the last qualifier displayed more completely. 
-- AMBIGUOUS HELP SYNONYM 
The qualifier referenced as a synonym was not unique. 


-- CANNOT INITIALIZE FILE STORAGE REGION CORRECTLY 


The HELP text could not be buffered adequately. Reenter the 
command line. 


-- CANNOT OPEN OUTPUT FILE 


The output file specified with the /OUT:filespec keyword 
cannot be created. This message can occur for several 
reasons. For example, the device may be write-locked or you 
do not have the necessary access privileges for the 
specified UFD. 


-- EXCESSIVELY NESTED OR RECURSIVE SYNONYMS 


A string synonym used in the help file has probably been 
defined recursively. 


-- HELP FILE ERROR nnn 


The help file could not be opened for the reason specified 
by the FCS code nnn. If the code number is -26, the help 
file does not exist. See the IAS/RSX-11 I/O Operations 
Reference Manual for definitions of the error codes. 


-~- HELP SYNONYM NOT FOUND 


The help file referenced a synonym, but the file did not 
include it. 
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HEL 


HEL 


HEL 


HEL 


HEL 


HEL 


-- ILLEGAL SWITCH -— NOT LOGGED IN 

You attempted to reference a local or group help file or 
output help text to another file without being logged in. 
Log in on the system and then enter the HELP command line. 


-- IMPROPER HELP FILE FORMAT 


The help file is not in proper format and cannot be used. 
Either edit the file or reenter it in proper format. 


-- INDIRECT HELP FILE OPEN ERROR 


HELP attempted to reference another file from within the 
help file, but could not open the indirect file. 


-- INDIRECT HELP FILE SYNTAX ERROR 


HELP encountered a syntax error either in a reference to 
another file or in the indirect file itself. 


-- SWITCH SYNTAX ERROR 


You specified a keyword incorrectly. Reenter the command 
Lines 


-- UNKNOWN HELP QUALIFIER 


The help file does not contain the last qualifier displayed 
in the command line below the error message. 
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The HOME command allows you to modify certain fields in the home block 
of a Files-11 disk volume. After you make the changes, HOME performs 
extensive checks to ensure that a good home block is written back onto 
the volume. If any of these checks fail, HOME attempts to place an 
alternate home block on the first free block on the home block search 
path. If this is completed successfully, HOME issues a warning 
message about the new home block. However, you should copy the volume 
as soon as possible because the alternate home block could be 
destroyed while the volume is mounted. 


To use the HOME command, you must first install the INI task with the 
task name ...HOM as follows: 


>INS SINI/TASK=...HOM 


The difference between INI and HOME is that INI writes the home block 
of a volume whereas HOME changes the information in the home block 
(without changing anything else). Because the HOME command and_ the 
INI command are implemented within the same task, they share many of 
the same error messages. See the description of the INI command for 
explanations of these common messages. 


Also be aware that you cannot use the HOME command on RSX-11M V3.2 (or 
earlier versions) or on RSX-11M-PLUS V1.0 and get the desired results. 


Format: 
HOM[E] ddnn:volume-label/keyword(s) 


ddnn: 


The volume whose home block you want to modify. 


volume-label 
The current label for the volume. 

/keyword(s) 
The specifications for the fields you want to modify in the home 
block. Each keyword defaults to the value specified for the 
particular field when the volume was initialized. The keywords 
do not change the files created by the INI command. 

Keywords: 
/DENS=density 

Checks the density of a floppy disk. If specified, the 


drive density iS compared against the keyword value for 
consistency. Acceptable values are: HIGH and LOW. 
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/EXT=block-count 


Specifies the default file-extend size. A file must be 
extended when it has used all of its allocated space. Legal 
values for block-count range from 1 through 255(10). 


Note that if you specify /EXT=0, no files (including the 
system files) can be extended. Therefore, although there 
may be free space on the disk volume, unless there are also 
free file headers, new files cannot be created on the 
volume. (If there are no free headers and the index file 
cannot be extended, no new files can be created.) 


/FPRO=[system,owner ,group,world] 
Specifies the default protection for the files on the 


volume. Access codes consist of four 4-code groups in the 
access rights word as follows: 


R - Read 

W - Write 

E - Extend 
D - Delete 


In each instance, the absence of the code means that the 
user class is denied the access right. 


The user classes (system, owner, group, world) are 
positional. That is, the location of the word in the string 
defines the user class to whom the code applies. The order 
is: 


[system,owner ,group,world] 
The square brackets are required syntax. 


Substitute an asterisk (*) for the access codes to force the 
default value for a specific class. 


/LRU=directory-count 


Specifies the approximate number of directories that will be 
accessed simultaneously. The F1L1ACP maintains a list of the 
most recently used directories. The value you specify for 
/LRU sets the number of entries in this list. In general, 
Girectory operations can be speeded up sSignificantiy by 
increasing the number of entries. 


If a directory appears in the list, no disk I/O is required 
for finding the directory in the Master File Directory 
(MFD). In addition, directory operations do not require the 
directory file header to be read. If you do not use /LRU, 
the default for directory-count is the value specified when 
the volume was initialized. 


Legal values for directory-count range from 1 through 
E27-(1:0)-« Note that increasing the value for /LRU increases 
the number of File Control Blocks (FCBsS) used and may 
increase the amount of system pool used. See the 
appropriate system generation manual for more information. 
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Also note that if you specify /LRU=0, the F1l1ACP will not 
keep a list of directories. This is not recommended and 
could have an adverse effect on system efficiency. 


/MXF=file-count 


Specifies the maximum number of files allowed on the volume. 
This number corresponds to the number of file headers in the 
volume's index file. The value for /MXF includes the five 
system files and cannot be greater than the total number of 
bits allocated to the index file bitmap. Use the following 
algorithm to determine the maximum number of files allowed 
on your volume: 


maximum = (4096.)* (current-number-of-index-file-bitmap-blocks) 
The number of index file bitmap blocks depends on the 
maximum number of files currently allowed on the volume. 
Use the /VI keyword to obtain this number and read _ the 
description of the /INF keyword for the INI command to 


determine how many index file bitmap blocks are on the 
volume. 


Note that you also cannot reduce the maximum number of files 
already specified for the volume. 


/NAME=new-volume-label 
Specifies a new label for the volume. 

/OVR (P) 
Instructs the HOME command to override label processing so 
that a volume can be modified without specifying a volume 


label. 


/OWNER=[group,member] 


Specifies the owner of the volume. This keyword is 
identical to /UIC. Legal group and member numbers range 
from 1 through 377(8). The square brackets are required 
syntax. 


/PRO=[system,owner ,group,world] 


Specifies the default protection for a volume. Access codes 
consist of four 4-code groups in the access rights word as 


follows: 
R - Read 
W - Write 
C - Create 
D - Delete 


In each instance, the absence of the code means that the 
user class is denied the access right. 
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/UIC= 


/VI 


The user classes (system, owner, group, world) are 
positional. That is, the location of the word in the string 
defines the user class to whom the code applies. The order 
is: 


[system,owner ,group,world] 
The square brackets are required syntax. 


Substitute an asterisk (*) for the access codes to force the 
default value for a specific class. 


{group,member] 


Specifies the owner of the volume. Legal group and member 
numbers range from 1 through 377(8). The square brackets 
are required syntax. This keyword is identical to the 
/OWNER keyword. 


Lists the HOME keywords and their values for the specified 
volume. 


/WIN=retrieval-pointer-count 


Example: 


>HOM 


Specifies the number of mapping pointers to be allocated for 
file windows. A file window consists of a number of mapping 
pointers and is stored in memory when the file is opened. 
(See the IAS/RSX-11 1/0 Operations Reference Manual for a 


description of mapping . pointers.) The 
retrieval-pointer-count must be 1 through 127(10). 


DKO: TEST/MXF=2357./VI 


** Volume information for DKO: ** 


Label = TEST 

/Cha = [] 

JEXt = 100. 

/Epro = [RWED,RWED, RWED,R] 
/Lru = 3. 

JMx£ = 2357. 

/PLrO = [RWED, RWED, RWED, RWEDj 
/Uie ee Gl ere 

/Win = 7. 


Maximum possible files = 4096. 


The Homebliock revision count is 1, Last revised on 11-AUG-81 
VYolume created on 11-AUG-81 at 19:47:37 


~~ Re 
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3-76 April 1983 


MCR COMMANDS 


HOM (Cont.) 


Command Error Messages: 


NOTE 


If you receive an error message that is 
not listed here, see the description of 
the INI command for an explanation of 
the message. 


<bell>*** ATTENTION ***<bell> 
THIS VOLUME IS OPERATING WITH A REPLACEMENT HOME BLOCK 
PLEASE TAKE THE ACTION OUTLINED IN THE DOCUMENTATION 


HOME could not ensure that a good home block would be written 
back to the volume, so it has placed an alternate home block on 
the first free block on the home block search path. The new home 
block is not allocated to or mapped by any file. You should copy 
the volume as soon aS possible because many operations on a 
mounted volume could destroy the replacement home block. 


HOM -- FAILED TO FIND HOME BLOCK 
HOME could not locate the home block of the volume. 

HOM -- FAILED TO PLACE ALTERNATE HOME BLOCK 
When HOME cannot ensure that a good home block will be written 
back to the volume, it attempts to place an alternate home block 
on the first free block of the home block search path. This 
message indicates that the attempt failed. Note that your volume 
may be corrupted and therefore unmountable. 

HOM -- MXF LESS THAN OR EQUAL TO THE EXISTING VALUE 
The value specified with /MXF was less than or equal to the 
maximum number of files already specified for the volume. This 
value must be greater than the current number of files allowed. 


HOM -- SWITCH IS NOT LEGAL IN THIS MODE 


You attempted to use INITIALIZE keywords and/or their options 
with the HOME command. 


HOM -- WRONG VOLUME LABEL 


The volume label specified in the command line did not match the 
volume's current label. 
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The INITIALIZE VOLUME command produces a Files-1ll volume (see Section 
Zel)s On disk and DECtape, the command initializes the volume 
(destroys all existing files), writes a dummy bootstrap and a home 
block, and builds the directory structures. On magnetic tape, the 
command writes a volume label according to the ANSI X3.27-1978 
standard and writes a dummy file that destroys all existing files. 


Note that a magnetic tape volume produced by the INI command is 
considered to be a null volume. If you are going to transport a newly 
initialized tape to a non-RSX-11M/11M-PLUS system, you might first 
have to make the null volume comply fully with the ANSI standard. To 
produce an ANSI-standard volume, you must write an actual file or a 
nuli file on the tape. You can use the following command line to do 
this: 


PIP>ddnn: DUMMY=NL: 


On multiuser protection systems, you can initialize a volume only on 
allocated, private devices (that is, a device you have allocated). On 
RSX-11M systems that do not support multiuser protection, a user must 
be privileged to initialize a volume. 


Selecting appropriate values for the command parameters requires an 
in-depth knowledge of Files-ll. Refer to the IAS/RSX-11 I/0 
Operations Reference Manual for details of the Files-ll disk and ANSI 
magnetic tape structures. 


Format: 
INI[TVOLUME] ddnn:["]volume-label["] [/keyword(s) ] 


Note that you can use a hyphen (-) as the last character on a 
line to extend the INI command line when selected keywords cause 
it to exceed 80 characters (or whatever buffer size has been 
specified for the terminal). You can use any number of 
continuation lines, but the total command line cannot’ exceed 


512(10) characters, 


a 


ddnn: 


The device unit name and number of the volume to be initialized. 
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["]volume-label["] 


The volume label. This may be up to 12(10) characters in length 
for disk and DECtape, and up to 6 characters for magnetic tapes. 
The label identifies the volume and must be specified. 


For magnetic tapes, the volume label is usually a reel number 
that uniquely identifies the tape. The number is assigned by the 
installation and, according to the ANSI standard, cannot be 
duplicated within an installation. 


When you specify a volume label for the magnetic tape, you can 
use the following characters: the uppercase letters A through Z, 
the digits 0 through 9, and the following special characters: 


<space> !"%& ' () *+,-./: € =>? 73 


To use a label that contains a special character, enclose the 
label in quotation marks ("label"). To use a quotation mark ina 
label, you must use two quotation marks within the quoted string. 
For example, the label T"1% has to be specified in the command 
line as "T""1%",. Any lowercase letters specified in a volume 
label are converted to uppercase before any operations are 
performed on the volume. 


/keyword(s) 


The specifications for various characteristics you want the 
volume to have upon initialization. 


Keywords: 
/ACCESS="character" 
Allows the owner of a magnetic tape volume to specify the 
access protection for the volume. INI places "character" in 
VOL1 (the accessibility field), which is usually blank. 
Legal values for "character" are the uppercase letters A 
through Z, the digits 0 through 9, and the following special 
characters: 
<space> !"%$&' () ®*+,-.2./:< =>? 3; 


The default value for "character" is a space. 


Note that if any nonblank character is specified, only a 
privileged user will be able to mount the volume. 


/BAD=[option] 


Indicates that bad-block processing is to be included in the 


volume initialization. Consequently, bad blocks’ on the 
volume will be marked as in-use and cannot be allocated to 
files. 
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The brackets surrounding each option are required syntax. 
The options are: 


[MAN] Accept a bad block list specified from the 
terminal. 


[AUTO] Read the bad-block descriptor file on the 
last track of the volume created by the 
manufacturer's diagnostic routines or _ the 
Bad Block Locator Utility (BAD). 


[NOAUTO] Ignore the bad-block descriptor file and 
perform no bad-block processing. 


[AUTO,MAN] Read the bad-block file and, when done, 
accept blocks specified from the terminal. 


{OVR] Include the last track in the BADBLK.SYS 
file. This option assumes that’ the bad 
block file is located on the last good block 
before the last track. The option is only 
valid for devices that contain 
manufacturer-recorded bad block data in the 
last tracks (that is, DL:-, DM:-, and 
DR:-type devices). 


[OVR,MAN] Override the manufacturer's bad-block 
descriptor file and accept blocks specified 
from the terminal. 


Tf the command line specifies [MAN], INI prompts for bad 
blocks as follows: 


INI>LBN(S)= 
Bad blocks can then be entered in the format: 
blocknum:number 
where blocknum specifies the bad block number and _ number 
specifies the number of sequential bad blocks beginning at 
blocknum. 
INI requires the colon when you specify a sequence of bad 
blocks. Both blocknum and number default to decimal unless 


preceded by a pound sign (#). 


To specify a single block, simply enter the block number and 
omit the colon. 


To specify a sequence of bad blocks, separate each series of 
blocks with a space, tab, or comma. For example, the 
command line: 

INI>LBN (S)=100:2,3,200:100,45:1 


enters blocks 100, 101, 3, 200 through 299, and 45 as bad 
blocks. 


GQ 


=80 
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A null line (pressing the RETURN key in response to the 
prompt) displays the bad blocks. The first number in the 
display represents the beginning block of the sequence; the 
second number is the number of bad blocks in the sequence. 
(Note that the numbers are decimal.) 


To terminate bad block input, type CTRL/Z or press’ the 
ESCAPE key. 


The default option is /BAD=[AUTO]. INI obtains the bad 
block information from the manufacturer-recorded bad-block 
descriptor file located on the last track of an RKO06/07, 
RLOL/O2, or RMO02/03/05/80/RP07 disk. INI also searches the 
last track for a bad-block descriptor file created by the 
BAD utility. 


/DENS=density 


Sets the bit density (bits per inch or bpi) of a magnetic 
tape loaded on a TE16, TU16, TU45, TS11, TSVO5, TU80, TU77, 
or TU78 tape drive. Legal keyword values are: 


/DENS=800 
/DENS=1600 
/DENS=6250 
/DENS=HIGH 
/DENS=LOW 
Defaults: 


/DENS=6250 for TU78 volumes 
/DENS=1600 for TS11/TSVO5/TU80 volumes 
/DENS=800 for all others. 


The /DENS keyword checks the density of a floppy disk in an 
RX02 drive or of a tape on a TS11/TSV05/TU80 drive. If a 
/DENS value is specified, the drive density is compared to 
the keyword value for consistency. If a /DENS value is not 
specified, no consistency check is performed and the volume 
is initialized at its current density. 


/EXT=block-count 


Specifies the number of blocks by which a file is to be 
extended when the file has used all of its allotted space. 
Legal values for block-count range from 1 through 255(10). 


Default: /EXT=5. Note that if you specify /EXT=0, no files 
(including the system files) can be extended. Therefore, 
although there may be free space on the disk volume, unless 
there are also free file headers, new files cannot be 
created on the volume. (If there are no free headers) and 
the index file cannot be extended, no new files can be 
created.) 
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/FPRO=[system,owner ,group,world] 


Specifies the default protection for files created on the 
volume being initialized. Access codes consist of four 
4-code groups in the access rights word as follows: 


R - Read 

W - Write 

E - Extend 
D - Delete 


In each instance, the absence of the code means that the 
user class is denied the access right. 


The user classes (system, owner, group, world) are 
positional. That is, the location of the word in the string 
defines the user class to whom the code applies. The order 
is: 


[system, owner, group, world] 
The square brackets are required syntax. 


Substitute an asterisk (*) for the access codes to force the 
default value for a specific class. 


Default file protection: /FPRO=[RWED,RWED,RWED,R]. 
/INDX=index-file-position 


Specifies the logical block number for the index file. The 
keyword can be used to force the index file, the Master File 
Directory (MFD), and the storage allocation file to a 
specific volume location, usually to minimize access time. 
Four possibilities are available: 


BEG - Place the index file at the beginning of the 
volume. 

MID - Place the index file at the middle of the volume. 

END - Place the index file at the end of the volume. 

BLK:nnn - Place the index file at the specified block 


number. 


Defaults: /INDX=MID (disk devices), /INDX=BEG (DECtape, 
DECtape II, and ML11). 


/INF=initial-index-file-size 


Specifies the number of file headers to allocate initially 
in the index file. The five system files (INDEXF.SYS, 
BITMAP.SYS, BADBLK.SYS, CORIMG.SYS, and 000000.DIR) are not 


included in the value for /INF. 
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Defaults 
DECtape 16 
DECtape II 16 
RA60 12308 
RA80 7314 
RA81 51699 
RC25/RCF25 L565 
RD51 602 
RF11 16 
RKO5 147 
RKO6 834 
RKO7 1654 
RLOL 314 
RLO2 629 
RM02/RM03 4049 
RMO5 25593 
RM80 7461 
RPO2 1230 
RPO3 2460 
RPO04/RP05 5283 
RP06 10478 
RPO7 51699 
RS03/RS04 16 
RXO1L/RX02 16 
RX50 16 
ML11 varies with disk size 


The maximum number of file headers that can be allocated to 
a volume is either determined by the value specified with 
the /MXF keyword or is defaulted. The defauit number is 
based on the size of the volume (see the description of /MXF 
for the calculation). The maximum number of file headers 
determines if the volume will have a l-, 2-, or 3-header 
index file. 


You need to determine the maximum number of file headers 
allowed on the volume before you can calculate the number of 
headers that will be preallocated initially. The number of 
preallocated file headers is determined by either the value 
you specify with /INF or a formula that uses the value you 
specify with /MXF. The following list gives the three 
general formulas (one for each type of index file): 


1l-header index file 


headers = maximum/2 
headers The initial number of preallocated file 
headers. 
maximum The maximum number of files (specified 


with /MXF). 


If headers is less than 100(10), INI preallocates 16(10) 
file headers for your volume. 


2-header index file 


headers = maximum/2 or 25593(10), whichever is larger 
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3~header index file 
headers = maximum/2 or 51699(10), whichever is larger 


See the description of the /MXF keyword for more information 
on multiheader index files. 


/LRU=directory-count 


Specifies the approximate number of directories that will be 
accessed simultaneously. The FI11ACP maintains a list of the 
most recently used directories. The value specified for 
7LRU sets the number of entries in this list. In general, 
directory operations can be speeded up significantly by 
increasing the number of entries. 


If a directory appears in the list, no disk I/O is required 
for finding the directory in the Master File Directory 
(MFD). In addition, directory operations do not require the 
directory file header to be read. 


Legal values for directory-count range from 1 through 
127(10). Note that increasing the value for /LRU increases 
the number of File Control Blocks (FCBS) used and may 
increase the amount of system pool used. See the 
appropriate system generation manual for more information. 


Also note that if you specify /LRU=0, the FL1ACP will not 
keep a list of directories. This is not recommended and 
could have an adverse effect on system efficiency. 


Default: /LRU=3 
/MXF=file-count 


Specifies the maximum number of files allowed on the disk 
volume. This number corresponds to the number of file 
headers in the volume's index file (see the description of 
the /INF keyword). The value for /MXF includes the five 
system files and must be less than or equal to the number 
specified for the device in Table 3-2. In general, for a 
disk of size N, the default number of files is calculated as 
follows: 


default-MXF = (((N-((N+4095.) /4096.) +9.) *127.)/258.) 


The value also decides if the volume will be a Files-ll 
level 401 or 402 volume. Level 402 volumes will have a 
multiheader index file and allow up to 65,500 files on them. 
INI creates the multiheader index file and modifies the 
volume's home block automatically if the value specified is 
greater than 25,593. (If 65K index file support is not 
specified for the INI task, the largest value allowed for 
/MXF is 25,593. With 65K support, the largest value is 
65,500.) Note that such volumes are not backwards compatible 
from RSX-11M V4.0 or from RSX-11M-PLUS V2.0. INI issues a 
warning message about the incompatibility when it creates a 
structure level 402 volume. 
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Table 3-2 
Number of Files Allowed on Volumes 


Maximum Default 
Theoretical Number of | Number of 
Maximum Default Index Index 


Device 


| 

DECtape 278 34 i 1 
DECtape II 247 30 1 1: 
RA60 disk 65500 24617 3 1 
RA80 disk 65500 14629 3 1 
RA81 disk 65500 54815 3 3 
RC25/RCF25 disks 25045 3130 1 1 
RD51 disk 9633 1204 1 1 
RF11l disk 499 62 1 1 
RKO5 disk 2357 294 1 1 
RKO6 disk 13344 1668 1 1 
RKO7 disk 26466 3308 2 i 
RLOL disk 5034 629 1 1 
RLO2 disk 10074 1259 1 1 
RMO2/RM03 disks 64798 8099 3 1 
RMOS diskl 65500 30781 3 2 
RM80 disk 65500 14923 3 1 
RPO2 disk 19680 2460 if 1 
RP03 disk 39365 4920 2 1 
RPO4/RPO5 disks 65500 10567 3 1 
RPO6 disk 65500 20956 3 1 
RPO7 diskl 65500 62007 3 3 
RSO3 disk 499 62 1 1 
RSO4 disk 1003 125 1 1 
RXO1 disk 238 29 1 1 
RX02 disk 481 60 i 1 
RX50 disk 388 48 1 y 
ML11 disk varies with size of disk 


Value 


1. Not backwards compatible by default. 


A 


NOTE 


volume requires 


CORIMG.SYS, and 000000.DIR -- to 
the IAS/RSX-11 I/0 Operations 
must be 


structure 
Reference Manual). Thus, the /MXF value 
computed by the maximum number of user UFDs and 


Headers 


create 


Headers 


five 


BADBLK.SYS, 
disk 


files plus the five files required for the Files-1l 
structure. 


/OWNER=[g,m] (disks, DECtapes, and magnetic tapes) 
/OWNER="owner" (magnetic tapes only) 


Specifies the owner of the volume. It is similar to /UIC, 
but for magnetic tapes allows you to use a syntax other than 
[ig,m]. /OWNER="owner™ allows you to change the entire 
"owner identifier" field in the volume label block if this 
is necessary for interchange with other systems. 
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/PRO=[system,owner,group,world] 


Specifies the default protection for a volume. Access codes 
consist of four 4-code groups in the access rights word, as 
follows: 


R — Read 
W - Write 
C - Create 
D - Delete 


In each instance, the absence of the code means that the 
user class is denied the access right. 


The user classes (system, owner, group, world) are 
positional. That is, the location of the word in the string 
defines the user class to whom the code applies. The order 
is: 

[system, Owner, group, world] 


The square brackets are required syntax. 


Substitute an asterisk (*) for the access codes to force the 
default value for a specific class. 


Default volume protection: /PRO=[RWED,RWED,RWED,RWED]. 


/UIC=[groupd,member] 


/VI 


Specifies the owner of the volume. Legal group and member 
numbers range from 1 through 377(8). The square brackets 
are required syntax. 


Default: /UIC=[1,1]} 


Lists all of the INI keywords and their values for the 
specified volume. 


/WiIN=retrieval-pointer-count 


Specifies the number of mapping pointers to be allocated for 
file windows. A file window consists of a number of mapping 
pointers and is stored in memory when the file is opened. 
(See the IAS/RSX-11 I/0 Operations Reference Manuai for a 


description of mapping pointers.) The 
retrieval-pointer-count must be 1 through 127(10). 


Default: /WIN=7. 
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>INI DK1: ICTSVOL2/UIC=[2,5] /INDX=BEG/FPRO=[RWED, RWE, RW, R] 


> INI 
¥* VO 


Label 
/Bad 
/Cha 
J/EXt 
/Fpro 
/Indx 
/inf 
/Lru 
/MxE 
/Pro 
/Vic 
/Win 


Theor 


Command Er 


The INITVOLUME parameters used in the example are: 


DK1: Device unit 
ICTSVOL2 Volume label 


/UIC User Identification Code 
owner: group=2, member=5 


of the volume 


/INDX=BEG Index file location, forced to beginning of 


volume 


/FPRO Default file protection, specified by class 


ass 


system: Read,Write,Extend,Delete 
owner: Read,Write,Extend 


group: Read,Write 
world: Read-only 


DKO: TEST/EXT=100./VI 


lume information for DKO: ** 


100. 


Mid 


294. 

[RWED, RWED, RWED, RWED] 
{1,1] 

73 


bu v bbb uw ut te wea 


etical maximum files = 2357. 


ror Messages: 


INI -- ALLOCATION FOR SYS FILE EXCEEDS VOLUME LIMIT 


The system was unable to allocate a_ system 
specified block because of intermediate 
end-of-volume. 


INI -- BAD BLOCK FILE CORRUPT - DATA IGNORED 


Although automatic bad block recognition was 


file from 
bad blocks 


selected, 


the 
or 


the 


bad block data on the disk was not in the correct format and 


was therefore ignored. 
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INI -- BAD BLOCK FILE FULL 

The disk had more than 102(10) bad regions on it. 
INI -- BAD BLOCK HEADER I/O ERROR 

An error was detected in writing the bad-block file header. 
INI ~- BLOCK(S) EXCEED VOLUME LIMIT 


The specified block (or blocks) exceeded the physical size 
of the volume. 


INI -- BOOT BLOCK WRITE ERROR 

An error was detected in writing the volume boot block. 
INI -- CHECKPOINT FILE HEADER I/O ERROR 

An error was detected in writing the checkpoint file header. 
INI -- COMMAND I/O ERROR 

INI encountered an I/O error while reading the command line. 
INI -- COMMAND TOO LONG 


The command, including continuation lines, exceeded _ the 
maximum length of 512(10) characters. 


INI -- DATA ERROR 


The command specified a bad-block number or contiguous 
region that was too large. 


INI -- DEVICE NOT ALLOCATED TO THIS TERMINAL - ddnn 
The command line specified a private device that was 
allocated to a terminal other than the one from which the 
command was issued. 


INI -- DEVICE NOT IN SYSTEM - ddnn 


The command line specified a device not in the current 
system configuration. 


‘INI -- DEVICE NOT MOUN 


INI ~- DEVICE NOT READY - ddnn 


The command line specified a device that was not ready (not 
up to speed). 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 
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-- DEVICE OFFLINE 


The specified device is in the system but not presently 
on-line. 


-- DEVICE WRITE LOCKED - ddnn 


The command line specified a volume that was write-locked 
and therefore could not be initialized as a Files-1l volume. 


-- DISK IS ALIGNMENT CARTRIDGE 
The last track on an RKO6/07, RLO1/02, or RM02/03/05/80/RP07 
identified the volume as an alignment cartridge, which 
cannot be initialized as a Files-11 volume. An alignment 
cartridge is specifically formatted for aligning disk 
read/write heads. 
-- DRIVER NOT LOADED 


The command line specified a device for which the driver has 
not been loaded. 


-- DUPLICATE BLOCK(S) FOUND 


INI attempted to define a block as bad that had already been 
defined as such. 


-- FAILED TO ATTACH DEVICE - ddnn 
INI could not attach the specified device. 
-- FAILED TO READ BAD BLOCK FILE 
The command was unable to read the bad block information 
from the last track OF an RKN6/07, RLO1/02, or 
RMO02/03/05/80/RP07 disk. 
-- FAILED TO READ MANUFACTURER'S BAD SECTOR FILE 
A disk read (hardware) error occurred when INI attempted to 
read the manufacturer-recorded bad block data on a 
last-track device. Reenter the command line and include the 
/BAD=OVR option. 
-~ FAILED TO READ SOFTWARE BAD SECTOR FILE 


The software-detected bad sector file could not be read. 
Reenter the command line and include the /BAD=OVR option. 


-- HOME BLOCK ALLOCATE WRITE ERROR 


While INI was overwriting a bad home-block area, a _ write 
error occurred. 


-- HOME BLOCK I/O ERROR 


nz. 


nm error was detected in writing the volume home block. 
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INI 


INI 


INI 


INI 


INI 


INT 


INI 


INT 


INI 


-- ILLEGAL ARGUMENT VALUE 


This message can occur for one or more of the _ following 
reasons: 


The value specified with /EXT was greater than 200(10). 
The value specified with /INF was less than 16(10). 
The value specified with /INF or /MXF was too large for 
the device type. 
The value specified with /LRU was greater than 127(10). 
The value specified with /WIN was greater than 127(10). 
-- ILLEGAL KEYWORD VALUE 


The value you specified with the keyword is illegal. Check 
the description of the keyword for the legal values. 


-- ILLEGAL UIC 

The UIC you specified with the /UIC keyword is not a valid 
one or is in an incorrect format. Legal values for UICs are 
1 through 377(8) and are in the format [g,m]. 

-- INDEX FILE BIT MAP I/O ERROR 

An error was detected in writing the index-file bitmap. 
-- INDEX FILE I/O ERROR 

An error was detected in writing the index-file header. 
-~ I/O ERROR ON DEVICE ddnn: 

A fatal hardware error occurred on the specified device. 


-- I/O ERROR SIZING DEVICE - ddnn 


The system encountered an I/O error while sizing an RF11 
disk. 


-- MAGTAPE LABEL MUST BE SPECIFIED 


The command attempted to initialize a magnetic tape without 
specifying the required volume label. 


-~- MAGTAPE DEVICE ERROR —- ddnn 


While positioning the magnetic tape, the system encountered 
an I/O error. 


-- MAGTAPE WRITE ERROR — ddnn 


While writing to the magnetic tape, the system encountered 
an I/O error. 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 
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-- MANUFACTURER'S BAD SECTOR FILE CORRUPT 
The manufacturer-recorded bad block data on a last-track 
device is in an inconsistent format. Reenter the command 
line and include the /BAD=OVR option. 
-- MFD FILE HEADER I/O ERROR 


An error was detected in writing the Master File Directory 
(MFD) file header. 


-- MFD WRITE ERROR 


An error was detected in writing a block in the Master File 
Directory (MFD). 


-- MUTUALLY EXCLUSIVE SWITCHES SPECIFIED 


The keywords /ACCESS, /OWNER, and /UIC cannot be specified 
in the same command line. 


-- NO BAD BLOCK DATA FOUND 

Although automatic bad-block specification was selected, no 
bad-block file was found on the volume. This is only a 
warning; INI continues and initializes the volume. 


-- NOT FILE STRUCTURED DEVICE 


The system does not support Fiies-li on the specifie 
device. 


-- NULL FILE HEADER I/O ERROR 


An error was detected in writing null-file headers to the 
index file. 


-- PREALLOCATED TOO MANY HEADERS FOR SINGLE HEADER INDEX FILES 
The number you specified with the /INF keyword was greater 
than 25598(10); therefore, the volume would have to have a 
multiheader index file. 


-- PREALLOCATION INSUFFICIENT TO FILL 1ST INDEX FILE HEADER 


The number you specified with the /INF keyword was less than 
25588(10). 


-- PREALLOCATION INSUFFICIENT TO FILL 1ST AND 2ND INDEX FILE 
HEADERS 


The number you specified with the /INF keyword was less than 
51694(10). 
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INI -- PRIVILEGE VIOLATION 
This message can occur for the following reasons: 


e Only privileged users can use the /OVR_ keyword. 
(This is an error message for the HOME command.) 


e Only privileged users can initialize volumes in a 
nonmultiuser protection system. 


INI -- PUBLIC DEVICE — ddnn 


The command line specified a public device. Only private 
devices can be initialized. 


INI -- STORAGE BITMAP FILE HEADER I/O ERROR 


A fatal hardware error occurred while the storage bitmap 
file header was being initialized. 


INI -- STORAGE BITMAP FILE I/O ERROR 
An error was detected in writing the storage allocation file 
header. 

INI -- SWITCH IS NOT LEGAL FOR THIS DEVICE TYPE 


A keyword was specified that cannot be used with the 
specified device. Check the description of the keyword for 
the valid devices. 

INI -- SWITCH IS NOT LEGAL IN THIS MODE 


You attempted to use HOME keywords and/or their options with 
the INI command. 


INI -~ SYNTAX ERROR 
This message can occur for the following reasons: 
e The value specified with the /ACCESS keyword was 
more than one character long. 


@ The volume label for an ANSI magnetic tape contained 


. ase 
an invallda nharacter. 


e Illegal syntax was used during the manual input of 
bad block numbers. 


INI -- THIS PROGRAM MUST BE INVOKED AS AN MCR FUNCTION 
The task must be installed with the task name ...HOM or 
ee LNI. 
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INI 


INI 


INI 


INI 


INI 


INI 


-- UNDEFINED 
The command 
-- UNIT DOES 


The command 
support 800 
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DENSITY SELECTION 
line specified an illegal density value. 
NOT SUPPORT 800 BPI 


line specified 800 bpi for a drive that does not 
bpi. 


-- UNIT DOES NOT SUPPORT 1600 BPI 

The command line specified 1600 bpi for a drive that does 
not support 1600 bpi. 

-- UNIT DOES NOT SUPPORT 6250 BPI 

The command line specified 6250 bpi for a drive that does 
not support 6250 bpi. 

-- UNIT DOES NOT SUPPORT HIGH/LOW DENSITY SELECTION 

The command line specified HIGH or LOW density for a device 
for which the /DENS HIGH and LOW options are undefined. 
-- UNIT DOES NOT SUPPORT DENSITY SWITCH 

The command line specified multiple densities for a device 
that does not have multiple density capability. 
-- UNIT IS NOT AT LOW DENSITY 

The command line specified that a floppy disk in an RX02 


drive be 


initialized 


at low density, but the floppy was 


formatted at high density. 


-- UNIT IS NOT AT HIGH DENSITY 


The command 
drive be 


initialized 


in an RX02 
high density, but the floppy was 


line specified that a floppy disk 
at 


formatted at low density. 


-- VALUE OF 


The value specified with the /INF keyword plus 5 
system 


five 


(INF + 5) EXCEEDS /MXF 


(for the 
files) is greater than the maximum number of 


files specified with /MXF. 


-- VOLUME MOUNTED FILES-11 


An attempt was made to initialize a mounted Files-11 volume. 
Mounted Files-11 volumes cannot be initialized. 


oa name “when 
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INI -- VOLUME NAME TOO LONG —- (volume name) 


The command line specified a volume label that exceeded 6 
characters for magnetic tape devices or 12(10) characters 
for disk or DECtape devices. 


INI -- WARNING -- BLOCK 0 IS BAD 


Block 0 of the specified volume, the boot block, was bad. 
Therefore, a bootable image cannot be placed on this volume. 
This is only a warning; INI continues and initializes’ the 
volume. 


INI -- WARNING -- THIS VOLUME IS NOT BACKWARDS COMPATIBLE 


INI has created a structure level 402 volume because _ the 
value specified with the /MXF keyword was greater than 
25,593. Level 402 volumes cannot be used on versions of 
RSX-11M previous to V4.0 or on RSX-11M-PLUS V1.0. 


WwW 
( 
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INSTALL (P) 


The INSTALL command makes a specified task known to the system. An 
installed task is dormant (not active) until the Executive receives a 
request for it to run. INSTALL accepts optional keywords that provide 
parameters that were not specified when the task was built or that 
override previously specified parameters. 


When you install a task, the system creates a Task Control Block (TCB) 
for the task in a memory-resident table called the System Task 
Directory (STD). The task parameters contained in the TCB enable the 
system to run the task when requested to do so by an MCR command or a 
system directive. You cannot run a task until it has been installed 
(see Section 2.5). (Note that the RUN command has an option that 
automatically installs and removes a task before and after running 
2 Est) 


A TCB contains both the address of the load-device Unit Control Block 
(UCB) and the Logical Block Number (LBN) of the task image file. 
Because task image files are contiguous, the Executive can load _ the 
task image in one transfer when an MCR command or system directive 
requests an installed task. (However, if the task is greater than 32K 
words, loading requires more than one transfer.) 


When you install a task in a virgin system, the system stores the task 
image file's LBN in the task header. When the system is saved, the 
SAVE task places the file identification, rather than the file's LBN, 
in the TCB. Then when the system is rebooted, it opens the task file 
and stores the new current LBN of the task in the TCB. If a task has 
been deleted, the system cannot open the task file when the system is 
rebooted. The system then automatically removes the task's TCB- from 
the STD. 


A saved system does not retain the physical addresses of installed 
tasks. The Disk Save and Compress (DSC) and Backup and Restore (BRU) 
utilities can compress and copy a disk containing a saved system, thus 
moving the task files to different physical locations. However, 
because the TCB entries contain task file identifications rather than 
LBNs, the system can function normally when it is rebooted. 


Formats: 


INS[TALL] [$]filespec[/keyword(s) ] 
filespec 
The file specification in the form: 


ddnn:[g,m] filename.type;version 
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The type defaults to TSK; Standard defaults apply to _ the 
remaining fields. 


When you specify $ in the command line, ddnn: defaults to LB:, 
and [g,m] defaults to the current system UIC (usually, [1,50] for 
an unmapped system and [1,54] for a mapped system). 


Note that if LB: has been reassigned to another device and that 
device's system UIC contains privileged tasks built for another 
system, your system will crash. 


Keywords 


/CKP=option 


on- RSX- 1M systems, ie 
the /CKP ‘keyword is. disabled f 


Specifies whether or not a task will be checkpointable. The 
options are YES and NO. If you specify /CKP=YES (the 
default for checkpointable tasks), checkpointing is allowed. 
If you specify /CKP=NO, checkpointing is disabled for the 

task. . 


The /CKP keyword overrides the /CP switch specified at task 
build. 


On systems that support the dynamic allocation of checkpoint 
space, the task image file does not need to contain 
allocated checkpoint space. The presence of the /CKP=YES 
keyword instructs the system to allocate checkpoint space, 
when required, for the task from a checkpoint file. (See 
the ACS command for more information on allocating 
Sheep Po Te BPRES ) 


was. patie. with the Pe switch, 
or the task. Oe Se 2 
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/CLI=option 


Specifies that the task being installed is a command line 
interpreter (CLI). The options are YES and NO. You must 
install a CLI with the YES option before you can set a 
terminal to that CLI (SET /CLI) or work with the CLI by 
means of the CLI command. 


/INC=size 


(Mapped systems only.) Increments the address space 
allocated to a task that runs in a esystem-controlled 
partition. The variable size is the number of additional 
words of address space to allocate. The increment is 
usually expressed in octal, but may also be expressed in 
decimal by appending a period. 


This keyword overrides the EXTTSK or PAR option used at 
task-build time. Tasks that specify the size of the 
partition in which they are running use this keyword to 
identify how much dynamic space they may allocate to symbol 
tables or buffers. Tasks such as MAC, TKB, PIP, VFY, and 
AT. (Indirect) use the space from the end of the task image 
to the end of their address space as dynamic memory. In 
effect, the /INC keyword defines the number of words in this 
dynamic region. 


You cannot extend a task that uses memory-resident overlays. 
(See the RSX-11M/M-PLUS Task Builder Manual.) 


Default: Either the size specified at task-build time or 
zero (0). 


/1OP=option 


Specifies that a privileged task can overmap the I/0 page. 
The options are YES and NO, If you specify /IOP=YES, 
INSTALL assumes that the task will overmap the I/O page (APR 
7) and, if the task is larger than 8K words, issues a 
warning message. If you specify /IOP=NO, INSTALL assumes 
that the task does not need to use the I/O page. No warning 
message is issued. 


/IOP complements the Task Builder /IP switch. Specifying 
/IP informs INSTALL that the task is intentionally 
overmapping the I/O page. 


Default: /IOP=YES. 

/PAR=pname 
Overrides the partition name specified at task-build time. 
In an unmapped system, the specified partition must have the 


same base address as the partition for which the task was 
buLley 
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If the keyword specifies a nonexistent partition, the system 
issues a warning message and attempts to install the task in 
the GEN partition. 


Default: TKB uses the name GEN. (See the RSX-11M or 
RSX-11M-PLUS System Generation and Installation Guide for an 


explanation of multiuser system defaults.) 
/PMD=option 


Requests a Postmortem Dump if the task aborts. The two 
options are YES and NO. If you specify /PMD=YES, a 
Postmortem Dump occurs if the task aborts because of an SST 
error condition. If you specify /PMD=NO, no dump is 
requested at SST abort time. 


To generate a dump, the Postmortem Dump task PMD... must be 
installed in the system. This keyword overrides the /PM 
Switch specified at task-build time. 
Default: Specified at task-build time. 

/PRI=number 
Specifies the priority for the task. The value range is l1 
through 250(10), where 250 is the highest priority. The 
standard numbering conventions apply: octal by default, 
decimal if followed by a period. 


Default: /PRI=50. 


consist of four 
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Specifies slave status for the task. The options are YES 


and NO. If you specify /SLV=YES, 


task is marked with the terminal 
sending it. When the installed 
system sets the task's TI: to 
data. This keyword overrides 
task build. 


If you specify /SLV=NO, the TI: 
when the task receives data. 


data sent to the installed 
number (TI:) of the task 
task receives the data, the 
that associated with the 
the /SL switch specified at 


of the task does not change 
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ee 


Default: Specified at task build. 


/SYNC=option 


(RSX-LIM-PLUS multiprocessor systems only.) Synchronizes 
task use of a common. The options are YES and NO. This 
keyword permits several tasks to share a common and use the 
common for synchronization. If you specify /SYNC=YES for 
two or more tasks, only one of the tasks can execute at one 
time. Note that if one of the tasks becomes blocked, the 
others compete to execute. 


The /SYNC keyword prevents inconsistent data that occurs as 
the result of race conditions. For example, if two tasks 
access a common, the /SYNC keyword ensures that only one 
task executes at one time. This prevents the second task 
from reading or writing tne common while the first task is 
executing. 


Default: /SYNC=NO. 

/TASK=taskname 
Specifies the name by which the system refers to the task. 
Default: The name specified at task-build time or the first 


6 characters of the file name. (See the RSX-1IM or 
RSX-11M-PLUS System Generation and Installation Guide for an 


/UIC=[group ,member] 


Specifies the UIC for the task. The square brackets are 
required syntax. You can also override the UIC with the RUN 
command. 


The task UIC determines the file-protection class (system, 
owner, group, world) to which a task belongs and thus 
directly influences file access. Note that file protection 
may differ from file to file. 
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Default: specified at task-build time. This default 
applies only to tasks started by a SPWNS, RPOIS, or RUNS 
directive or a RUN command that specifies a time delay 
before run time. Tasks started by typing the name as a 
command (for example, PIP and TKB) run under the default UIC 
of the terminal from which the command was issued. 
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Examples: 

>INSTALL SCAN 
Installs task SCAN. Priority and UIC are defaulted. 

>INSTALL DM1:[1,111]SCAN.TSK;4/PRI=103 
Installs task SCAN, file type TSK, version 4 on device DMl:, 
group number 1, member number 111, with a priority of 
103(8). 

>INS MAC/INC=4096./PAR=SYSCTL 


Installs task MAC in the system-controlled partition SYSCTL 
and increases the task size by 4096(10) words. 


Command Error Messages: 
INS -- ADDRESSING EXTENSIONS NOT SUPPORTED 


The command tried to install a task with a VSECT (virtual 
section) into a system that does not support the feature. 


INS -- BASE ADDRESS MUST BE ON 4K BOUNDARY 


The base virtual address of the task waS not on a 4K 
boundary. This message applies only to mapped systems. 


INS -- BASE MISMATCH COMMON BLOCK common-name 


The base address of the partition did not match that of the 
common block. 


INS -- CANNOT INSTALL PRIVILEGED TASK FROM NON-PRIVILEGED TERMINAL 
This message applies to multiuser protection systems only. 


A nonprivleged user attempted to install a privileged task. 
Only a privileged user can install a privileged task. 
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INS -- CAN'T INSTALL DIRECTIVE COMMON 


An attempt was made to install a task in a directive common, 
which the system does not support. 


INS -- CAN'T INSTALL EXECUTIVE COMMON 


The executive commons (on systems that support executive 
partitions) cannot be installed at run time. The commons 
must be installed with the VMR INSTALL command. (See the 
RSX-11M/M-PLUS System Management Guide). 


INS -- CHECKPOINT AREA TOO SMALL 


The area allocated for checkpointing the task was smaller 
than the partition into which the task was being installed. 
This message applies only to systems that do not support the 
dynamic allocation of checkpoint space. 


INS -- CHECKPOINT SPACE TOO SMALL, USING CHECKPOINT FILE 
This is a warning message only. The checkpoint space 
allocated in the task image file is too small for the size 
of the task (usually because of the /INC keyword). The 
system supports the dynamic allocation of checkpoint space 


and will therefore use a checkpoint file to contain the 
checkpointed task. 


INS -- COMMON BLOCK IS TASK PARTITION common-name 


A task's request for access to a common block was’ rejected 
because the requested partition was a task partition. 


INS -- COMMON BLOCK NOT LOADED common-name 
The specified common block was linked to the task but had 
not been installed in the system. Install the common block, 
then install the task. 

INS -- COMMON BLOCK OCCUPIED 


An attempt was made to load a task into a common block that 
was already occupied. 


INS -- COMMON BLOCK PARAMETER MISMATCH common-name 


Parameters of a common block did not match those in the 
task's label block. 


INS -—-- COMMON BLOCK SEGMENT COUNT ERROR 
The command installed a resident library with overlays, but 
the number of overlay segments specified in the task header 


was different from the number specified in the segment 
descriptions. 
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INS -- EXTERNAL HEADERS NOT SUPPORTED 
INSTALL first checks to see that the task was built with /XH 
specified. Then, it checks the feature mask bit of the 
system to see if external headers are supported. When 
external header support is not included in the system, you 
cannot install a task with an external header. 

INS -- FILE NOT CONTIGUOUS 
An attempt was made to install a noncontiguous task image 
file. Task images can only be contiguous files. 

INS -- FILE NOT PROPERLY CLOSED 
An attempt was made to install a file that was not properly 
closed (that is, locked). Since the file is locked, it is 
probably corrupted. Install a new copy of the file. 

INS -- FILE NOT TASK IMAGE 
Data in the label block was not correct, indicating that the 
File was not a task image. 

INS -- FILE PROTECTION VIOLATION 
An attempt was made to install a task to whose image file 
you do not have proper access. You must have read access to 
install a task image file. 

INS -- ILLEGAL DEVICE ddnn: 
The device specified at task build by the assign (ASG) 
option does not exist in the system. This is a warning 
message only. The task is installed. 

INS -- ILLEGAL DEVICE/VOLUME 
The specified device was not a valid task-residence device. 

INS -- ILLEGAL FIRST APR 
(Mapped systems only.) A privileged task, built to run using 
APR 4 or 5 as its base, was too large. Using APR 4, the 
task was larger than 12K; using APR 5, the task was larger 
than 8K. 
If the Executive has been built to support 20K of address 
space, APR 5 is the only valid base APR for tasks mapping 
into the Executive. A privileged task that does not map 
into the Executive must use APR 0 as its base. (See the 
RSX-11M/M-PLUS Task Builder Manual for a description of the 
/PR switch.) 

INS -- ILLEGAL PRIORITY 


The value of the priority specified in the command was out 
of range (that is, not 1 through 250 decimal). 
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INS 


INS 


INS 


INS 


INS 


-~- LENGTH MISMATCH COMMON BLOCK blockname 


The length parameter for the common block, as described in 
the label block for the task image, did not match the 
corresponding length parameter defined in the system. A 
task's label block data must match system data for that task 
before it can be installed. 


-~- LOW POOL, TRY LATER 


(Systems with pool monitoring support only.) During low pool 
conditions, the Pool Monitor Task (PMT...) temporarily 
disables install-run-remove and /CMD requests for 
nonprivileged users. 


-~ NO CHECKPOINT SPACE, ASSUMING NOT CHECKPOINTABLE 


This is a warning message only. The command attempted to 
install the task as checkpointable, but the task was not 
built as checkpointable and therefore had no checkpoint 
space allocated in its task image file. Because the system 
does not support the dynamic allocation of checkpoint space, 
it considers the task not to be checkpointable. 


-- NO CHECKPOINT SPACE OR DYNAMIC CHECKPOINT FILE 
An attempt was made to install either an external header 
task (/XHR=YES) or a checkpointable task (/CKP=YES), but no 
checkpoint space or dynamic checkpoint file was available 
for it. 
-- NO ROOM AVAILABLE IN STD FOR NEW TASK 
No dynamic memory was available to enter the Task Control 


Block (TCB) in the System Task Directory (STD). The task 
could not be installed. 
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INS -- NOT ENOUGH APRS FOR TASK IMAGE 


(Mapped systems only.) The Task Builder allows the user to 
specify the virtual base address of a task image as a 
multiple of 4K. Privileged tasks that access the Executive 
start at either virtual address 100000(8) for a 16K 
Executive or at virtual address 120000(8) for a 20K 
Executive. If the virtual base address is set too high, 
there are not enough APRS remaining to map the task image. 
(See the RSX-11M/M-PLUS Task Builder Manual for information 
on privileged tasks.) 


INS -- PARTITION NOT COMMON 


A partition specified for a common area or library is not 
defined as a common partition. 
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INS -- PARTITION parname NOT IN SYSTEM, DEFAULTING TO GEN 
This is a warning message only. The specified partition 
does not exist, so the system attempts to install the task 
in the GEN partition. 


INS -- PRIVILEGED TASK LARGER THAN 12K 


A privileged task was larger than 12K words. Privileged 
tasks on an unmapped system have a maximum size of 12K. 


INS -- PRIVILEGED TASK NOT MAPPED TO I/O PAGE 


A privileged task was larger than 8K and therefore 
overlapped the I/O page. This message occurs if the task is 
installed with the /IOP=YES option. 


INS -- SPECIFIED PARTITION FOR COMMON BLOCK 


An attempt was made to install a task in a common block. 


INS -- SPECIFIED PARTITION TOO SMALL 


The task being installed was larger than the partition into 
which it was being installed. 


INS -- TASK AND PARTITION BASES MISMATCH 


(Unmapped systems only.) The base of the partition did not 
match the base of the task being installed. 


INS -- TASK IMAGE ALREADY INSTALLED 


The requested task image, which was checkpointable, had 
already been installed. On systems that do not support the 
dynamic allocation of checkpoint space, checkpointable tasks 
that have checkpoint space allocated can be installed only 
once; other tasks can be installed more than once (under 
different names). 


INS -- TASK IMAGE I/O ERROR 
INSTALL could not read the task image file or could not 
rewrite the task image header. (The device is 
write-locked.) 

INS -- TASK IMAGE VIRTUAL ADDRESS OVERLAPS COMMON BLOCK blockname 
The virtual addresses reserved for the task image overlap 
those reserved for the common block specified in the 


message. A corruption of the task image file probably 
caused the overlap. 
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INS -- TASK MAY NOT BE RUN 


This message can be issued for the following reasons: 


1. An attempt was made to run a CLI task. CLI tasks 
are activated by the system; they cannot be 
activated with the install-run-remove option of the 
RUN command. 


INS -- TASK NAME ALREADY IN USE 


An attempt was made to install a task with the same name as 
one already in the system. 


he dynamic stora 


INS -- TOO MANY COMMON BLOCK REQUESTS 


A task made too many requests for common blocks. A task is 
limited to seven requests. 


INS -- TOO MANY LUNS 
A task requested more than 255(10) LUNS to be assigned. 


INS -- UNDEFINED COMMON BLOCK blockname 


A task referenced a common block that had not been defined 


in the system. Usually, this message indicates that the 
task was built for another system. 


ae mba 
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INS -- WARNING -- PRIVILEGED TASK OVERMAPS THE I/0 PAGE 


A privileged task that is mapped into the Executive is 
usually also mapped into the I/0 page to access’ the 
registers for the KT11 and other devices. Many tasks do not 
require this access and can use the additional 4K words of 
virtual address space for the task image. This message 
warns that a task that may require access to the I/O page 
might have grown too large. 
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LOAD (P) 


The LOAD command reads a nonresident (loadable) device driver into 
memory and, if necessary, relocates the data base constructs and 
interrupt-vector linkages required to allow access to the device. On 
RSX-11M-PLUS systems, the task CON constructs interrupt-vector 
linkages. 


The LOAD command eliminates the need to link infrequently used device 
drivers permanently into the Executive. (Executive support of 
loadable device drivers is a system generation option on RSX-11M 
systems but is always included on RSX-11M-PLUS systems.) The result is 
the potential for an increase in the amount of system dynamic memory. 


You can load drivers that are up to 8K words in length. Note, 
however, that the loadable device driver itself must map to any 
locations above 4k. 
The driver for a device, for example ZY:, can indicate association 
with a partition by allocating one word in the driver and labeling it 
with the global symbol S$ZYCOM. If $ZYCOM is defined in a driver, you 
cannot load the driver until you create ZYCOM (LOA writes the PCB 
address of ZYCOM into SZYCOM). 
Format: 

LOA{D] dd:[/keyword(s) ]} 
dd: 

A 2-character ASCII loadable device driver name. 
Keywords: 


/PAR=parname 


Specifies the partition (parname) into which the driver is 
to be OndeS 


Bela oer 


All loadable drivers are usually placed in the same 
partition, by convention DRVPAR. This has the advantage of 
g 


prevent? p fragmentation of the GEN partition. 


When the command line omits this keyword, the system loads 
the driver into the partition specified when the driver was 
burt. 
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/SIZE=parsize 


Specifies the minimum size (in words) of the partition into 
which the driver is to be loaded. If the partition is 
system-controlled, a subpartition will be created at this 
size. 


parsize is rounded up to the next highest unit of 100 
(octal) words and must be less than 100000. 


/HIGH 


If the partition is system-controlled, /HIGH causes’ the 
driver to be loaded as high in the partition as possible; 
absence of /HIGH loads the driver as low in the partition as 
possible. 


If the partition is not system-controlled, the driver 
occupies the entire partition whether or not you specify 
/ HIGH. 


Examples: 


>LOAD MM: !LOAD TU16 DRIVER (MMDRV) 
>LOA LP: /PAR=DRVPAR !LOAD LP11 DRIVER (LPDRV) INTO DRVPAR 
Notes: 

e Rigid instructions for building loadable device-driver tasks 
are defined in the RSX-11M or RSX-11M-PLUS Guide to Writing an 
I/O Driver. Note that the system generation procedures 
include provisions to simplify the task building of drivers. 

e It is not possibie to make aii device drivers loadable. Also, 
not all loadable drivers can have loadable data bases. 
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e The LOAD command requires that a driver's TSK and STB files 
reside under the system UIC on the system disk (LB:). For 
example, the command 


LOA ODT: 


requires that the files DTDRV.TSK and DTDRV.STB reside on LB: 
under the appropriate system UIC. The command SET /SYSUIC 
displays and defines the system UIC; the usual values, 
however, are [1,50] for an unmapped system and [1,54] for a 
mapped system. 


e The LOAD command does not initiate checkpointing to free a 
space in a partition. 


e The LOAD command requires pool space as follows: 


1. If the driver data base is being loaded, the data base 
needs contiguous pool space equal to its size. 


2. In a mapped system, each interrupt entry in the driver 
needs pool space for an Interrupt Control Block (ICB). 


3. If the driver is being loaded into a _ system-controlled 
partition, the Partition Control Block (PCB) needs pool 
space. 

Command Error Messages: 


LOA -- CANNOT LOAD/UNLOAD A PSEUDO DEVICE 


The device you attempted to load is a pseudo device. Pseudo 
devices do not have drivers. 


LOA. Roche CTR. name “DOES. ‘NOT. EXIST oe . oo. 
-(RSX- -11M-PLUS- systems” ‘onty. 5 The. Controller Table name 


_ specified with the /CTB Revere does not. exist in the. 
resident. data PRE RNR ARS ORR ERS EI Suge 


LOA ae cre. (NAME name Is * DUPLICATE 


dable | data base eontaine 
me. that: is the same as a 
TR names must be 


(RSX=11N- -PLUS- 
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LOA -- DEVICE dd: NOT IN SYSTEM 


The data base for the device driver was not in the system or 
in the driver's task image. 


LOA -- DEVICE NOT MOUNTED 
The system device (LB:) was not mounted. 
LOA -- DRIVER ALREADY RESIDENT 


The specified device driver had already been loaded or is 
permanently resident. 


LOA -- DRIVER BEING LOADED OR UNLOADED 


The Executive was effecting another request to load or 
unload the driver. 


LOA -- DRIVER BUILT WITH WRONG EXECUTIVE STB FILE 


The STB file for the driver was not compatible with the 
current Executive. The task build probably specified an 
RSX11M.STB file that was not for the current system. 


LOA -- FILE filename HAS ILLEGAL STB FORMAT 


The driver's STB file contained an illegal object code or 
data record format. 


LOA -- FILE filename NOT A VALID DRIVER TASK IMAGE 


The driver's task image was either overlaid or had a task 
header. 


eel 


MCR COMMANDS 
LOA (Cont.) 


LOA -- FILE ddDRV.TSK NOT CONTIGUOUS 


The file ddDRV.TSK was not contiguous. Device drivers (like 
all "task" images) must be contiguous. 


LOA -- ILLEGAL DRIVER TASK APR USAGE 
A device driver must be built for APR 5 and must be less 


than 8K (for example, PAR=DRVPAR:120000:40000). This 
message applies to mapped systems only. 


LOA -- ILLEGAL VALUE FOR SYMBOL symname IN FILE filename 


The symbol symname is defined to an illegal value in file 
ddDRV.STB. This can occur for several reasons, some general 
and some specific to individual symbols. For example, 
symbols cannot have odd values, most symbols cannot be 
defined as zero, $ddTBL must exist and have a value less 
than SddEND, and mapped loadable drivers cannot reference 
SINTSV. 


LOA -- INSUFFICIENT POOL SPACE 


The required amount of system dynamic memory was not 
available. 


ISUFFICIENT 1 ICB POOL SPACE FOR: CPU CPx 


is not enough Oro AEERE Mauerda nt dynami 


ate an Interrupt ener l Block for ‘the Cc ated 
he error message. This message appli to 
“LIM= =PLUS MULE DLOCOSSOr noe. and SS RERPAa: aye Eade 
Loa - = “INTERRUPT VECTOR ALREADY INISE a 
-(RSX-11M. systema, only. yx ‘dri Se vector does not 
point. to one of the nonsense interrupt entry points. oe 

LOA -- INVALID DRIVER DATA BASE AT OFFSET xxxx IN FILE filename 


The driver had an invalid data base value at offset xxxx 
relative to the symbol S$ddDAT. This can occur for three 
general reasons. 


1. An invalid value, for example, D.UCB was odd. 


2. The value for a word is not within the bounds of the 
loadable data base. LOAD produces an error message 
citing the offending value. 


3. An element is missing from the loadable data base. LOAD 
attempts to verify one kind of data structure as another 
Kind. For example, if a DCB is missing, LOAD tries to 
verify the following UCB as the DCB. LOAD cites the DCB 
as being incorrect. 
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LOA LOADABLE DRIVER SUPPORT NOT IN SYSTEM 


The system generation option to support loadable device 
drivers was not chosen or necessary routines are not in the 
Executive. 


LOA -- OPEN FAILURE ON FILE filename 


LOAD encountered an error in attempting to open the 
specified file. 


tempt was made. to. ‘bad | a “dauice 
OA device driver cannot be. 


oe -11M. systems on 
driver: into a commo: 


-Ain-oLus eystens only. y an See” was. 
driver. into a common partition. On x 
ip eannet be loaded into a. common “part. 
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LOA -- PARTITION parname TOO SMALL 


The partition into which the driver was to be loaded was not 
large enough to contain it. 


LOA -- REGION/PARTITION name IS A COMMON 


You have attempted to load a device driver into a common 
partition or region. A device driver cannot be loaded into 
a common partition or region. 

LOA -- SYMBOL symname IS DOUBLY DEFINED BY FILE filename 


The symbol symname is defined twice in the specified file. 
Duplicate symbols are illegal. The driver is not loaded. 


LOA -- SYMBOL symname IS UNDEFINED IN FILE filename 


The symbol symname was found in the specified file, but the 
symbol was not defined. 


LOA -- TASK IMAGE I/O ERROR IN FILE filename 


The device is probably write-locked. LOAD could not read 
the task image file or could not rewrite the task image 
header. 
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LOA -- WARNING - LOADABLE DRIVER LARGER THAN 4K 
Loadable drivers can be up to 8K words in length. The 
driver must explicitly map to any location above 4K words. 
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LOGICAL UNIT NUMBERS (NP) 


The LUN command displays the static LUN assignments for a _ specified 
task. (Static assignments are those recorded in the task's disk image 
file.) The display consists of a list of physical device units in one 
column and their corresponding LUNS in an adjoining column. 


When the specified task is running, the display does not necessarily 
reflect the running task's assignments. For example, an Executive 


directive issued from within the task (ASSIGN LUN) can alter the LUN 
assignments. 


Tf the specified task was initiated by the install-run-remove option 
of the RUN command, the task has no static LUN assignments. In this 
case, LUN displays the message: 

LUN -- TASK NOT IN SYSTEM 


Format: 


LUN[S] taskname 


Example: 
>LUN XKE 
TIO: 1. 
SYQs- 2s 
SY0O2. “3% 
SY0O: 4. 
LBO: 5. 


The display shows static assignments for LUNs 1, 2, 3, 4, 
and 5, which are recorded in the task image file header; no 
other LUNs are statically assigned to the task XKE. 

Command Error Messages: 


LUN -- NO LUNS 


The task that is the argument of the LUN command did not 


have any logical assignments. This is an informational 
message. 
LUN -- TASK NOT IN SYSTEM 


The specified task is not installed or the task was 
initiated by the install-run-remove option of the RUN 
command. This is an informational message. 
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MOUNT (NP,P) 


The MOUNT command allows the file system software access to physical 
devices. For all volumes on these devices, MOUNT creates the file 
system control blocks that the Ancillary Control Processors (ACPs) use 
to support data access on the device. MOUNT also declares, provided 
an on-line access path exists, that the volume is logically on line 
for access. The command then requests the ACP to mount the volume or 
volume set. Mounting a volume also resets the QIO and Error counts to 
zero (0). These counts are used by the Error Logging facility. 


The MOUNT command supports three types of devices: file-structured, 
sequential, and non-file-structured. Disks and DECtapes are examples 
of file-structured devices. These devices are usually controlled by 
F1L1ACP, which supports Files-1ll Structure Level 1. Magnetic tapes are 
an example of a sequential device. These tapes are usually controlled 
by MTAACP, which supports both ANSI (X3.27-1978) and unlabeled tape 
formats. Non-file-structured devices do not have to be mounted on 
RSX-1L1M but must be mounted foreign on RSX-11M-PLUS. 


When you mount a Files-1ll or magnetic tape volume, there are several 
default ACPs that MOUNT can use. MOUNT first defaults the ACP name to 
ddnnFl. This allows you to tailor the ACP that controls a_ specific 
volume and then name that ACP after the volume. For example, if you 
tailor FLIACP for an RKO6 disk and install it as DMOILF1, then when you 
issue a MOUNT command for DMl:, MOUNT searches for the ACP DMOIFI1. 
For disks, if MOUNT cannot find an ACP whose name is in the form 
ddnnFl, it searches for an ACP whose name is in the form ddAACP and 
then F1L1ACP. For magnetic tapes, the default ACPs are ddnnFl, ddAACP, 
and then MTAACP. Note that (for privileged users) these defaults can 
be overridden by using the /ACP keyword. 


It is recommended for slow disk devices such as DECtape that a 
separate ACP be used. Thus, you should install a copy of FI11ACP as 
DTAACP for DECtape and a copy as DDAACP for DECtape II. 


RSX-11M systems permit specific tasks,° such as INI and DSC, access to 
unmounted volumes.:=However, it is necessary to mount a magnetic’ tape 
if it is an ANSI standard tape or if you want to process the “tape as 
an unlabeled. .tape with FCS or. RMS on a system that supports ANSI 
magnetic tapes. If the .system.does: not support ANSI tapes, FCS 
processes unmounted magnetic tapes as unit record devices. sie 


When a device is dismounted, outstanding I/0 is allowed to complete, 
but no additional files can be accessed on that volume (see the 
description of the DISMOUNT command). 
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MOUNT also classifies devices and volumes into three other types: 
public, shared, and nonshared. A public volume is one that all system 
users can access. Public volumes are the only type supported by 
nonmultiuser systems. A shared volume is one that can be mounted 
multiple times by multiple users. A nonshared volume (private) is one 
allocated to a single user. See Chapter 2 for more information on 
device types. 


A nonprivileged user can only mount a volume on: 


e The user's private device. No other user can access or mount 
the volume until the volume is dismounted and deallocated. 


e Any other device that has not been allocated or set public. 
If another user mounts the volume, that user can also access 
it. 


Only one user can mount a magnetic tape volume (or volume set) at one 
time. 


Some file attributes and positioning information can be supplied after 
the volume is mounted with the MAG utility. For more information, see 
the IAS/RSX-11 I/0 Operations Reference Manual. 

If the device is not ready when you attempt to mount the volume, MOUNT 
waits from 30 to 60 seconds for the device to become ready. If the 
device is still not ready after the waiting period has elapsed, MOUNT 
issues an error message. 


The following descriptions of the MOUNT command formats illustrate the 
parameters and keywords associated with Files-1l volumes and with ANSI 
magnetic tapes. All the keywords are collectively described following 
the format descriptions. 


You can use a hyphen (-) as a line terminator to extend the MOUNT 
command line when selected keywords cause the command to exceed 80 
characters (or whatever buffer size has been specified for the 
entering terminal). You can use any number of continuation lines, but 
the total command line cannot exceed 255(10) characters. 
Note that since the override volume label keyword (/OVR) is a 
privileged option of the MOUNT command in a multiuser protection 
system, a nonprivileged user must always specify a volume label. 
Formats: 

Files-1l Disk or DECtape Format: 

MOU [NT] ddnn: [label] [/keyword(s) ] 
ddnn: 


Device unit on which the volume is to be mounted. Default: 
none; must be specified. 
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label 


The Files-11 volume label may be null or up to 12(10) 
characters in length. It is used to ensure that the correct 
volume is being mounted. In a multiuser protection system, 
the command must include a volume label unless’ the 
privileged /OVR keyword is present. 


/keyword(s): 


MOUNT keywords for Files-1l devices override corresponding 
values in the volume's home block. 


/ACP=option /PRO=option 
/DENS=density / PUB 
/EXT=block-count / (NO] SHARE 
/FOR /UIC=uic-spec 
/FPRO=[system,owner,group,world] /UNL 
/LOCK=option /VI 
/LRU=directory-count /(NO]WAIT 
/OVR /WIN=option 
/PARM="user parameters" /{NO]WRITE 


ANSI Magnetic Tape Format: 


Magnetic tapes, unlike disks and DECtapes, can be mounted by the 
set as well as singly. In fact, when you mount a single magnetic 
tape, you are mounting a set consisting of only one tape. A tape 
set consists of logically related records or files written on one 
or more reels of tape. Only the first tape in the set has to be 
loaded on a device at the time the MOUNT command is issued, but 
all tapes in the set can be loaded on different devices when the 
command is issued. 


The tape set is identified by a File Set Identifier. Each tape 
in the file set is identified by a Volume Identifier. By 
default, the File Set ID is the same as the Volume ID of the 
first reel of tape in the set. If. this is true for your tape 
set, it is not necessary to specify the Volume IDs for the tapes 
(although it is recommended). 


Volume Identifiers should be assigned by the system manager and 
should be unique within the installation. The Volume ID is 
usually the reel number of the physical tape. A File Set 
Identifier, however, is a name chosen by the user to refer to his 
or her own tape. 
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If your tape set processing uses more volumes than you specified 


with 


the /VOL keyword, you can use any expired or newly 


initialized tape for the output volume. For input, you can use 


only 


the next volume in the tape set. To determine if the new 


input tape is the correct one, the system checks the tape's File 


Set 


ID, file sequence number, and file section number. If 


specified, the system also checks the Volume ID. 


MOU[NT] device-list:[{file-set-ID] [/keyword(s) ] 


device-list 


file- 


One or more device names on which the volume or volume set 
is to be mounted. More than one device name can be 
specified only for multivolume ANSI magnetic tape sets. Tf 
the command specifies more than one device name, the names 
must be separated by commas and enclosed in parentheses, 
that is: 


(ddn>:;dan: ;ddn<«<s) +4 


Note that when you specify more than one device name, you 
must always access the tapes through the first name given in 
the device list. (This also applies when you dismount’ the 
tape set.) If you attempt to access a tape through another 
device name, you will get an error message. 


set-ID 


The File Set Identifier (or File Set ID) can be up to 6 
characters in length. The File Set ID is the name you 
choose for the tape set. By default, it is the same as_- the 
first Volume Identifier (Volume ID) in the volume set. To 
create a tape set with a File Set ID that is different from 
the Volume ID of the first tape in the set, specify both the 
File Set ID and the first tape's Volume ID. 


If you are mounting a newly initialized tape, you can 
specify your own File Set ID by using a_ form of the 
following command line (note that the /VOL keyword is’ used 
because the File Set ID and Volume ID are not the same): 


>MOU MM:MYSET/VOL=A234 


See the description of /VOL for more information about 


Volume IDs. 

File Set IDs can use the following characters: the digits 0 
through 9, the uppercase letters A through Z, and the 
following special characters: 


ae 


<space> ! " Be OG |) ees og ae Re eg 

To uSe a name that contains a special character, enclose the 
name in quotation marks. To use a quotation mark in the 
name, you must use two quotation marks within the quoted 
string. For example, the label T"1% should be specified as 
sa Wit oe Le ae 


3= 1.2.0 
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Any lowercase letters specified in a File Set ID or Volume 
ID are converted to uppercase before any operations are 
performed on the tape. Any other invalid character is 
converted to a question mark (?). 


/keyword(s): 


Keywords: 


/ACP=option /OVRFSID 
/BS=n /PARM="user parameters" 
/CC=option /PRO=option 
/DENS=density /PUB 

/ FOR /RS=n 
/EPRO=protection-spec / [NO] SHARE] 
/ {NO] HDR3 /TR=option 
/ [NO] LABEL /UIC=[uic] 
/LOCK=option /VI 

/OVR /VOL= (list) 
/OVRACC /(NO]WAIT 
/OVREXP / [NO] WRITE 


/ACP=option (P) 


Specifies the name of the ACP to be used as the file 
processor for the volume being mounted. The option can be 
the name of a task that is installed as an ACP or it can be 
UNIQUE, which specifies that a dedicated ACP is to be used 
for the volume. 


You only need to specify an ACP in special cases. If an ACP 
has been written for a customer application in your 
installation, you will need to use that ACP for volumes used 
by that application. 


When you specify the UNIQUE option, MOUNT creates a copy of 
the FLIACP if the device is a disk or DECtape or of MTAACP 
if the device is a magnetic tape. This unique ACP is given 
a name in the form ddnnFl or ddnnAP. When the volume is 
dismounted and the file processor exits, the ACP is 
automatically removed. 


Default: Depends on the device type. 
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/BS=n 


/CC=0 


/DENS 


/EXT= 


Specifies the block size for an unlabeled magnetic tape 
volume or the block size for files on an ANSI labeled tape 
that are Level 1 or 2 (do not have an HDR2 record). The 
value for n can be from 14 (for unlabeled tapes) or 18 (for 
ANSI tapes) through 16000. /BS also specifies the default 
block size for newly created files on an ANSI magnetic tape. 


ption 


Specifies the record type for an unlabeled magnetic tape 
volume, or the record type for files on ANSI labeled tapes 
that are Level 1 or 2 (do not have an HDR2 record) or that 
are Level 3 but do not have a system code (HDR CP 61) 
beginning with DEC or OS. The options are: 


FOR 
LIST 
NONE 


These options correspond to the FORTRAN keywords for the 
OPEN statement. 


=density 
The density (bits per inch or bpi) of the medium loaded on 


the drive. Acceptable density values depend on the device 
type as indicated below: 


TE16 800 bpi (or LOW) or 1600 bpi (or HIGH) 
TS11 1600 bpi 

TSVO5 1600 bpi 

TU45 800 bpi (or LOW) or 1600 bpi (or HIGH) 
TU77 800 bpi (or LOW) or 1600 bpi (or HIGH) 
TU78 1600 bpi or 6250 bpi 

TU80 1600 bpi 


Defaults: 


TEL6 /DENS=800 

TS11 /DENS=1600 

TSVO5 /DENS=1600 

TU45 /DENS=800 (or LOW) 
TU77 /DENS=800 

TU78 /DENS=6250 

TU80 /DENS=1600 


If you specify more than one device type in the command 
line but do not specify a density, the default is the 
lowest density supported by all of the devices. 


block-count 
Specifies the number of blocks by which a file can be 
extended when it exhausts its space allocation. The 


block-count must be 1 through 255({10). 


Default: The value specified when the volume was 
initialized. 
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Indicates a foreign (non-Files-11) volume. 


On RSX-11M, this keyword is recommended but not required for 
mounting foreign volumes. If you do not mount: the volume, 
access to the volume is unrestricted. If you. specify /FOR 
when you mount a volume on a private device, no. one else can’ 
access it. Se, e eee ae 


If you do not specify an ACP name (with /ACP=option), a file 
system (an ACP) cannot access the volume. Absence of an ACP 
name permits tasks (such as INI, DSC, BAD, or user tasks 
executing non-file-structured device QIOs) access to 
non-Files-11 volumes. 


/FPRO=protection-spec 


Specifies the default file protection for files created on a 
Files-11 disk while the disk is mounted. The protection 
specification has two formats: 
(SYSTEM: RWED, OWNER: RWED, GROUP: RWED,WORLD: RWED) 
or 


[RWED, RWED, RWED, RWED] 


The access codes consist of four 4-code groups in the access 
rights word as follows: 


R - Read 

W - Write 
E - Extend 
D - Delete 


In each instance, the absence of the code means that the 
applicable user is denied the access right. 


Default: Values taken from volume home block. 


/ [NO] HDR3 


Specifies whether an HDR3 label is to be written when 
creating new files. The /NOHDR3 keyword is needed only when 
it is known that the target system cannot handle a tape with 
an HDR3_ label. This keyword has no other effect or 
application, 


Default: /HDR3. 
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/ {NO} 


LABEL 


Specifies that a magnetic tape volume is in ANSI format 
(/LABEL) or unlabeled (/NOLABEL). Default: /LABEL. 


/LOCK=option 


“On RSX=11M, this key 
syolomes 0 


Specifies the default value for the DISMOUNT /LOCK keyword. 


only for magnetic tape 


The options are: 


Nounload 
Unload 
Virtual 


When you specify the Nounload option (/LOCK=N), the volume 
valid bit is cleared, but the disk is not spun down or the 
tape unloaded. This is the default option for volumes 
mounted foreign and no ACP specified. For example, when you 
want to initialize a volume as a Files-1l volume, you first 
issue a MOUNT command with the /FOR’ keyword. After 
initializing the volume, the usual procedure is to dismount 
it and then issue another MOUNT command, using a standard 
ACP. Since the default lock value is N, the volume remains 
spinning or loaded and you can immediately issue the MOUNT 
command that specifies the ACP. 


When you specify the Unload option (/LOCK=U) for disks, the 
volume valid bit is cleared and, if the drive supports the 
spin-down function, the disk is powered down. When you 
specify this option for tapes, the tape is rewound and 
unloaded. This option is the default lock value for all 
volumes mounted with a standard ACP. 


/LRU= 


The Virtual option is privileged. When you specify /LOCK=V, 
the volume valid bit is not cleared and the disk is not spun 
down or the tape unloaded. 


See the description of the DISMOUNT command for more 
details. 


directory-count 


Specifies the approximate number of directories that will be 
accessed simultaneously while the volume is mounted. The 
FLIACP maintains a list of the most recently used 
directories. The value specified for /LRU sets the number 
of entries in this list. In general, directory operations 
can be speeded up significantly by increasing the number of 
entries. 
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If a directory appears in the list, no device I/0 is 
required for finding the directory in the Master File 
Directory (MFD). In addition, directory operations do not 
require the directory file header to be read. 


Legal values for directory-count range from 0 through 
12710): Note that increasing the value for /LRU increases 
the number of File Control Blocks (FCBs) used and may 
increase the amount of system pool used. See the 
appropriate system generation manual for more information. 


Also note that if you specify /LRU=0, the FI11lACP will not 
keep a list of directories. This is not recommended and 
could have an adverse effect on system efficiency. 


If you do not use /LRU, the default for directory-count is 
the value specified when the volume was initialized. 


(P) 


For disks and DECtapes, instructs the MOUNT command to 
override label processing so that a volume can be mounted 
without specifying a volume label. 


For magnetic tapes, instructs the MOUNT command to override 
File Set ID processing on the first tape of a tape set so 
that a volume can be mounted without specifying a File Set 
ID. 


When you specify /OVR, the File Set ID is taken from the 
first volume in the set. However, MOUNT still checks the 
IDs for the remaining volumes in the _ set. This prevents 
improper tape processing. (Note that Volume IDs for the 
tape volumes are overridden if they are not specified, 
whether or not you use /OVR.) 


/OVRACC (P) 


Instructs the MOUNT command to override the protection for 
an ANSI magnetic tape volume. 


/OVREXP (P) 


Instructs the MOUNT command to override the expiration date 
on the tape volume(s). 


/OVRFSID (P) 


Instructs the MOUNT command to ignore File Set Identifiers 
on the second and subsequent magnetic tape volumes of a 
multivolume set. /OVRFSID may cause improper tape 
processing. This keyword should be used only if you know 
the volume does not conform to the ANSI standard. 
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/PARM="uSer-parameters" 


Instructs the MOUNT command to pass nonstandard parameters 
from the command line to a foreign ACP. The user-parameter 
string can consist of up to a maximum of 40(10) characters 
enclosed in quotes ("). The quotation marks are not 
included when the characters are counted. 


If the quoted parameter itself includes a quotation mark, 

the quotation mark must’ be followed by another quotation 

mark. 

This keyword is valid only with foreign (/FOR) volumes. 
/PRO=protection-spec 


Specifies the default volume protection for a Files-1ll disk. 
The protection specification has two formats: 


(SYSTEM: RWCD, OWNER: RWCD,GROUP: RWCD,WORLD: RWCD) 
or 
[RWCD,RWCD,RWCD, RWCD] 


The access codes consist of four 4-code groups in the access 
rights word as follows: 


- Read 

Write 

- Create at volume level; extend at file level 
- Delete 


Gaza 
| 


In each instance, the absence of the code means that the 
applicable user is denied the access right. 


Default: Values specified when the volume was initialized. 


/PUB 
Specifies that the volume is accessible by all users, 
depending on the volume and file protection set for the 
volume. The drive on which the volume is mounted is 
deallocated and set public if necessary. 
Defaults: /PUB if the volume is public 
/SHARE if the volume is not allocated or set public 
/NOSHARE if the volume is allocated to a user 
See Chapter 2 for more information on public devices. 
/RS=n 


Specifies the number of characters in a record for unlabeled 
magnetic tape volumes or the number of characters ina 
record for files on ANSI labeled tapes that are Level 1 or 2 
(do not have an HDR2 record). The value for n can be from 1 
through the value specified with /BS. 
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/ [NO] SHARE 


/SHARE specifies that a volume can be mounted multiple times 
by one or more users. Each user who mounts the volume gains 
access to it based on the volume and file protection 
established for the volume when it was first mounted. After 
all users have issued a DISMOUNT command and all file 
activity has ceased, the volume is released by the file 
processor. The volume is deallocated and set nonpublic if 
necessary. 

/NOSHARE specifies that the volume is reserved for dedicated 
use by the first user who mounted the volume. No other 
users can access the volume. The drive on which the volume 
is mounted is allocated to the user's terminal and set 
nonpublic if necessary. 


Defaults: /PUB if the volume is public 
/SHARE if the volume is not allocated or set public 
/NOSHARE if the volume is allocated to a user 


/TR=option 
Specifies the kind of character translation used in read and 


write operations on an unlabeled magnetic tape volume. The 
options are: 


NONE No translation takes place. 

EBCDIC Translation from EBCDIC to ASCII for read; 
ASCII to EBCDIC for write. (Note that 
translations are not completely 
symmetrical. Some characters in one set 


do not have equivalent characters in the 
other set.) 


UT1,. UT2;, Translation done by user-supplied 

UT3 Translation tables that have been 
previously linked into MTAACP. Up to 
three tables may be linked. 


Default: no translation takes place. (See the IAS/RSX-11 
I/O Operations Reference Manual for more information on 
character translation.) 


/UIC=[uic] 


Specifies the User Identification Code (UIC) for the volume 
owner in the form [group,member]. The square brackets are 
required syntax. The numbers for group and member range 
from 1 through 377(8). This UIC overrides the one specified 
when the volume was initialized. 
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/UNL 


/VI 


Specifies that the volume index file should be unlocked for 
write access by a system user. When locked, the index file 
is read-only; when unlocked, it is read or write. This 
keyword is typically required when you are recovering lost 
blocks or performing other maintenance with the VFY utility. 
(See the RSX-11M/M-PLUS Utilities Manual for more 


information.) Note that this keyword has nothing to do with 
device write-locking. 


Default: locked. 


Displays the volume information on the entering terminal. 


The information displayed is the characteristics with which 
the volume was mounted. 


For Files-1l1 volumes, the volume information format is: 


Volume Information 


Class: Files-1ll 

Device: ddnn 

Volume label:label 

Owner: [uic] 

Protection: [system,owner ,group,world] 
Default: [system,owner ,group,world] 
ProcesSSor: ACP name 


For last-track devices (for example, DL:, DM:, and DR:) and 


for DU:-type devices, /VI also displays, in octal, the pack 
serial number of the volume. 


For foreign volumes, the volume information format is: 
Volume Information 
Class: Foreign 


Device: ddnn 
Volume label:label 


For magnetic tape volumes, the volume information format is: 


Volume Information 


Class: ANSI labeled tape or Unlabeled tape 
Device: ddnn 

Fileset ID: id 

Volume ID: id 

Owner: [uic] 

Processor: ACP name 


For magnetic tape, the volume information repeats the device 
and label lines if multiple units were specified and omits 
the volume protection and characteristics defaults (volume 


protection and characteristics do not apply to magnetic 
tapes). 
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/VOL=(list) 


Specifies the Volume Identifier (Volume ID) for an ANSI 
magnetic tape. If you specify more than one Volume ID (for 
a multivolume tape set), the Volume IDs must be separated by 
commas. 


Initially, the tape with volume-ID-1 must be physically 
loaded on the first device unit specified in the command 
line. The remaining tapes may or may not be loaded on other 
units specified in the command line. You must specify 
Volume IDs in the order in which the volumes make up _ the 
volume set because the system searches for and/or requests 
each successive volume in the specified Volume ID order. 


The second and succeeding volumes should be mounted on_ the 
additional units in the order in which they were specified 
in the command line or as requested by console messages from 
MTAACP. 


If more tapes are required than were specified at mount 
time, MTAACP automatically adds additional volumes to the 
set. 


When the command line is issued, the system checks the tape 
on the first drive to ensure that it is the first volume of 
file-set-ID (see the format for MOUNT command lines’ for 
magnetic tapes). If you do not specify the /VOL keyword, 
the system does not check the Volume ID for the tape. 


For compatibility with previous RSX-11M/M-PLUS releases, the 
command line 


>MOU MM: (A,B,C) 
is equivalent to the command line 

>MOU MM:A /VOL=(A,B,C) 

/(NO]WAIT 

Specifies whether you require operator assistance in 
performing the mount. The main use of this keyword is for 
batch jobs, indirect command files, or terminals distant 
from the machine room. 
If you specify /WAIT in an interactive mount, a message 
concerning the mount is sent to the operator's console and 
the mount is not completed until the operator takes action. 
If you specify /NOWAIT in a batch job or indirect command 
file, or if the mount is interactive, no message appears. 
The volume must have been previously placed on the device 
and readied for access (spun up/brought on-line). 


Default: /NOWAIT. 
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/WIN=option 
Specifies the number of mapping pointers to be allocated for 
file windows. A file window consists of a number of mapping 
pointers and is stored in memory when the file is opened. 
(See the IAS/RSX-11 I/0 Operations Reference Manual for a 
description of retrieval pointers.) The number of retrieval 
pointers must be less than 129(10). 
/WIN accepts the following options: 

n All files are set up with this 
default unless overridden on 
access; legal values are 1 through 
127(10) or the FULL option. 

USER:n User default value for the volume. 

INDEX:n Number of pointers to allocate to 
the index file window 

(USER:n, INDEX:n) If n is not the same for both of 
these, defaults to the user default 
value for the volume default and to 
the number specified for the index 
file 

FULL Windows are created that map as 
much of the file as possible; FULL 
can be used for n in all of these 
options. 

Default: The number of pointers specified in the home block 
with either the INI or HOME command. 

/{(NO]WRITE 
/WRITE specifies that write operations are allowed on _ the 
volume (the volume is’ software write-enabled) within the 
limits of volume and file protection. 
/NOWRITE specifies that write operations are not allowed on 
the volume (the volume is software write-locked). 
Default: Write operations are allowed. 

Examples: 

>MOU DM1:AMBER 

Mounts the volume on device unit DMl:. (In this example, 


the optional parameters have not been specified. Therefore, 
MOUNT uses the parameter values in the volume's home block.) 
No volume information is displayed. 
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>MOU (MTO:,MT1:,MT2:)MYSET /VOL=(VOL1,VOL2,VOL3) 


Mounts the volume set MYSET on units MTO:, MTl:, and MT2:. 
Initially, VOL1 must be physically loaded on MTO:; the 
first volume in a set must always be loaded on the first 
unit specified in the command. VOL2 and VOL3 may or may not 
be loaded when the command line is issued. If they are 
loaded, they can reside on the remaining units in any order 
(for example, VOL3 could be loaded on MTl:). 


The system searches for the next volume in a set by Volume 
ID rather than by unit number; the order in which volumes 
are listed in the command line is the order in which the 
system searches for and/or requests the volumes. If VOL2 
and VOL3 are not loaded, the system requests each in turn. 
The volumes can be loaded on either MTO:, MTl:, or MT2:. 


>MOU DM1:SYS004/LRU=9/VI/WIN=20 


Mounts the volume labeled SYS004 on DMl:. The command line 
reserves space for nine directory File Control Blocks (FCBs) 
to remain in the ACP's pool or system pool, displays’ the 
volume information, and changes the default window block 
size for files opened on this volume to 20(10). 


Command Error Messages: 


See the IAS/RSX-11 1/0 Operations Reference Manual for 
definitions of the I/O error codes. 


MOU -- AMBIGUOUS KEYWORD 
<command-line> 


The abbreviation used for a keyword in the command line was 
too short for MOUNT to distinguish it from another keyword. 
Reenter the command line, using a longer form of the 
keyword. 


MOU -- COMMAND INPUT ERROR 
<I/O error code and text> 


An error occurred while MOUNT was attempting to read _ the 
command line. Correct the error condition listed and 
reenter the command line. 


MOU -- COMMAND SYNTAX ERROR 
<command-line> 


The command line is not in the proper format. The incorrect 
part of the command line is enclosed in brackets. Reenter 
the command line, using the correct syntax. 


MOU -- DEVICE DRIVER NOT LOADED 
The device driver for the specified device is not loaded. 


Load the device driver, using the LOAD command, and reenter 
the command line. 
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MOU -- DEVICE NOT MOUNTABLE 


The specified device cannot be mounted. Some devices do not 
require mounting although the media are removable. Verify 
that you are using the correct device and reenter’ the 
command line if necessary. 


MOU -- DEVICE NOT READY 


The specified device returned a device-not-ready status or 
failed to respond within approximately 60 seconds. Verify 
that you are using the correct device, ready the device, and 
reenter the command line. 


MOU -- DEVICE STATUS CHANGED DURING MOUNT 


The device status for the specified device changed between 
the inittal device classification and the final setting up 
of the data structures. This is usually the result of 
another user mounting or dismounting the volume 
simultaneously with the command in error. Verify the device 
status and reenter the command line. 


MOU -- FAILED TO ALLOCATE SUFFICIENT DYNAMIC STORAGE 


Mounting a volume may require a significant amount of 
primary or secondary pool for data structures and the ACP. 
Either MOUNT or the ACP was unable to allocate enough space 
in pool. Wait until activity on the system has lessened and 
then reenter the command line. 


“AILED TO SET VOLUME VALID BIT 
ror code and text> : 


(RSX-11M-PLUS systems oniy. ‘ A sha rAware ole aa id. is 
maintained | by certain hardware. When the ‘ateenpt was: made 
I: set this hardware ‘status bit, the. driver — returned an 
| error. Correct: the. hardware probtem and) reenter the. command 

lines: BO eee a 8 ene ae 


MOU -- FAILED TO START ANCILLARY CONTROL PROCESSOR 


The Executive was unable to start the ACP task. The task 
may be exiting or there may not be sufficient resources. 
Reenter the command line at a later time. 


MOU -- F1l1MSG NOT INSTALLED 


The task F11IMSG is not installed. Ask your system manager 
to install it. 


MOU -- I/O ERROR ON DEVICE 
<I/O error code and text> 


An I/O error occurred in the file system software while 
accessing the device. The line enclosed in brackets 
contains the specific error code returned by the system or 
the device driver. Correct the error condition and reenter 


the command line. 
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MOU -- INCOMPATIBLE DEVICES FOR MULTI-VOLUME SET 


MOU 


MOU 


MOU 


MOU 


MOU 


be 


The specified devices are incompatible in one or more of the 
following ways: 


All must be either disk or magnetic tape devices. 


All must be either public, allocated, or not 
allocated. 


If magnetic tapes, all must support either 7-track 
or 9-track and all must support a common density. 


Verify the device specifications and reenter the command 


line. 


INCORRECT FILE SET IDENTIFIER 


The File Set ID specified in the command line does not match 
that in the File Set ID field of the HDR1 label. Determine 
the correct File Set ID and reenter the command line, or 
reenter the command line specifying the /OVRFSID keyword. 


-~- INCORRECT VOLUME IDENTIFIER 


The Volume ID specified in the command line does not match 


that in 


the Volume ID field of the VOL1 label. Determine 


the correct Volume ID and reenter the command line, or 
reenter the command line without specifying any Volume ID. 


-- INCORRECT VOLUME LABEL 


The volume label specified in the command line does not 


match 


the volume label in the home block. Determine the 


correct volume label and reenter the command line, or mount 
the volume specifying the /OVR keyword. 


-- INSUFFICIENT PRIVILEGE FOR ATTEMPTED OPERATION 


An option specified in the command line requires that the 


user be privileged. 


-- INTERNAL LOGIC ERROR 


An internal programming error has been detected. This may 
the 
configuration or option selection. Retry the operation. If 


result of an unusual software or hardware 


the error persists, vary the options selected. In any case, 
submit a Software Performance Report (SPR) with a console 


listing 


of the command lines and error messages and as much 


information on the circumstances of the error as possible. 


MOU -- MAGTAPE IS NOT SHAREABLE, DEVICE IN USE 


The specified device is already mounted, or the command line 
requested 


shared or public access to the device. Magnetic 


tapes are sequential devices and are processed sequentially. 


Only one 
command line, specifying the /NOSHARE keyword. 


user can access a tape at one time. Reenter the 
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MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


-- MOUNT IS NOT NECESSARY FOR CASSETTES 
Self-explanatory. This is an informational message only. 
-- MOUNT NOT SUPPORTED FOR DEVICE CLASS 


Although the specified device is mountable, MOUNT is’ unable 
to process the command line for this class of device. MOUNT 
Supports only Files-1l random-access devices and _ labeled 
(ANSI) and unlabeled sequential tape devices. MOUNT does 
not support communications class devices such as DECdataway 
or DECnet. 


-- MULTI-VOLUME DISK NOT SUPPORTED 
MOUNT only Supports multivolume ANSI magnetic tape sets. 
-- NO HOME BLOCK FOUND OR STRUCTURE NOT SUPPORTED 


F11ACP was unable to locate a valid home block on_ the 
volume. The volume is either uninitialized, corrupted, or 
in an unSupported format such as Files-1ll Structure Level 2 
or RT-1l. (Certain utilities such as FLX support other 
formats such as DOS-11 and RT-11.) These volumes must be 
mounted with the /FOR keyword. 


-- NO SUCH DEVICE AVAILABLE 


The specified device name and unit was not found in _ the 
logical or physical device tables. Determine the correct 
device name and unit number and reenter the command line. 


-- NOT FIRST VOLUME OF TAPE SET 


Tape sets must be read from the first volume. The first 
tape volume of the tape set was not loaded on the first tape 
drive specified in the command line. 


-- OPERATION INVALID TO SPOOLED DEVICE 


The specified device has been redirected to an intermediate 
device for spooling. Generally, only unit record devices 
are spooled and are usually not mountable. If the device is 
mountable, the queue spooler processor servicing the device 
must be stopped and the device unspooled. 


-- PARAMETER CONFLICT WITH ALREADY MOUNTED VOLUME 


The volume was already mounted foreign and Files-ll access 
was requested or the volume was mounted Files-1l and foreign 
access was requested. 


-- REQUESTED DENSITY NOT AVAILABLE 
The density specified in the command line is not’ supported 
by the specified devices. Either specify the correct 


density or select hardware that supports’ the desired 
density. 
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MOU -- TAPE NOT ANSI OR INCORRECT TAPE FORMAT 


The tape labels did not conform to the ANSI standard or the 
tape is not an ANSI labeled tape. Specify other tape 
formats with the /NOLABEL and /FOR keywords. 


MOU -- UNIT ALLOCATED TO OR IN USE BY ANOTHER USER 
Another user has allocated the device or a task has the unit 
attached. Verify that the volume is loaded in the correct 
unit, that the correct unit is specified, and that no other 
user has allocated the device. 


MOU -- UNIT OFFLINE 


MOU -- UNIT SPECIFIED MORE THAN ONCE IN MULTI-VOLUME SET 


A device can only be specified once for a multivolume tape 
set. 


MOU -- UNRECOVERED DEVICE ERROR 


After the standard number of retries, the I/O operation 
still could not be successfully completed. This error 
message usually indicates an error in the media. Correct 
the problem and reenter the command line. 


MOU -- VOLUME ALREADY MOUNTED 


The volume is already mounted as nonshareable or is a public 
volume and cannot be mounted a second time. 


Mounted Magnetic Tape Messages 


Messages that begin with xxxxxx are from the Ancillary Control 
Processor (ACP) that is servicing your ANSI magnetic tape volume. 
The messages are generated by volume-switching operations’ for 
multivolume tape sets. 


A message first appears on the console terminal. If no action is 
taken before a timeout interval elapses, the message appears 
again on the console terminal and on the terminal that issued the 
command line. 
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These messages do not occur during the execution of the MOUNT 
command, but rather as ae result of operations performed by a 
system utility or user application program. 


XXXXXX -- EXPIRATION DATE NOT REACHED ON VOLUME volume-id ON ddnn 
MOUNT ANOTHER VOLUME ON DRIVE ddnn: OR PLACE ON-LINE TO 


A new output volume is being opened and the expiration date 
has not been reached. A new volume can be placed on line, 
in which case its expiration date is also checked. If the 
same volume or another volume with the same Volume ID is 
placed on line, the volume is overwritten even though it is 
not expired. 


This message occurs only on volume switching. If a program 
is creating a file and specifies the file position of a file 
whose expiration date has not been reached, the create 
operation terminates with IE.EXP. 


XXXXXX -- MOUNT NEXT VOLUME ON DRIVE ddnn: 


The ACP does not know the name of the next volume in the 
tape set. The next volume must’ be placed on the drive 
specified. When this message appears, the action to be 
taken depends on whether a program is currently reading or 
writing the set as follows: 


1. When writing, the ACP accepts any tape that has 
been properly initialized. The expiration date of 
the first file on the tape is checked to verify 
overwrite access. If the write-ring is missing 
when the tape is placed on line, the program 
writing to the tape will receive an error message. 


2. When reading, the next volume of the current volume 
set must be placed on the drive specified in the 
message. The Volume ID is not checked, but other 
consistency checks are made, depending on the type 
of read operation currently in progress. 


XXXXXX -- MOUNT volume-id ON DRIVE ddnn: 


Place the volume specified in the message on the drive 
indicated. The ACP knows the name of the volume because 
either multiple Volume IDs were specified in the command 
line or the ACP has already processed (and therefore 
remembers) the Volume ID while the tape set has_ been 
mounted. 


XXXXXX -- PLACE DRIVE ddnn: ON-LINE 


The next device drive requested in a muitivolume, muitiunit 
operation is off line. 


XXXXXX -~- REQUESTED ACTION FOR DRIVE ddnn: NOT COMPLETED 
This is a reminder message. It indicates that a condition 


reported in a previous message from xxxxxx has not yet been 
taken care of. 
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XXXXXX -- REQUESTED ACTION FOR TASK taskname ON DRIVE 
ddnn: NOT COMPLETED/PLEASE COMPLETE OR ABORT TASK 


This is a reminder message. It is displayed after a long 


delay. 


XXXXxXxX -- WRONG VOLUME MOUNTED ON DRIVE ddnn: 


A subsequent volume of a multivolume tape set has been 
placed on line, but the ACP does not think it is the correct 


volume. 


Ly 


This condition can occur for the following reasons: 


The MOUNT command line specified explicit volume 
IDs and the volume that should be mounted is not 
the one on the drive. 


The ACP has learned the volume sequence of the 
current tape set because of previous processing 
while the set has been mounted and the volume that 
should be mounted is not the one on the drive. 


The volume on the drive is not in ANSI format. 
A hardware error prevented the ACP from reading any 
of the labels in the label set at the beginning of 


the volume. 


Some other inconsistency in the volume label set 
has been encountered. 
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OPENREGISTER (P) 


The OPENREGISTER command allows examination and optional modification 
of a word of memory. To open a location within a task, the task must 
be fixed in memory. 


By default, OPEN displays a location and its contents in octal. 
Special control characters allow you _ to also have the information 
displayed in ASCII, Radix-50, double-byte, or decimal format. To 
specify a different format, type the desired control character 
followed by the ESCape key. You can do multiple conversions for _ the 
same location on one line. The display remains on the same line until 
you open the next location. 


You use the same control characters to insert new values into a 
location in ASCII, Radix-50, double-byte, or decimal format. In this 
case, type the desired control character followed by the new value and 
then press the RETURN key to insert the new value and open the next 
location. 


Format: 
OPE[N] memory-address [+ or - n][/keyword] 
memory-address /contents [control-character] [value] line-terminator 
The first line is the OPEN command line. The second line is’ the 
general format in which OPEN displays the contents’ of the 
location. After that, you can display and change the contents in 
various formats. 

memory-address 
A l- to 8-digit octal memory address (location). 


+ or - n 


One or more optional octal numbers to be added to or _ subtracted 
from the memory address. 


/keyword 


One of the keywords defined later in this text. The keywords 
apply only to mapped systems. 


control-character 


One or more optional special characters used to display values or 
insert new values in octal, ASCII, single-character ASCII, 
Radix-50, double-byte, or decimal format. The special characters 
and their related formats are: 


- octal (default format) 
- ASCII 

- Single-character ASCII 
Radix-50 

- double-byte 

- decimal 


7 Pe = EN 
( 
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Lline-terminator 


The line terminator directs the subsequent action of OPEN. Any 
value that is entered replaces the contents of the word whose 
address and current value are shown in the first part of the 
display line. The slash (/) is part of the display line. 


ESC 


ESCape or ALTMODE: ESC (ALTMODE) terminates acceptance 
of further input and is the only exit from the OPEN 
command. If used after a special control character, it 
converts the contents of a location from octal to the 
Gesired format. 


RETURN: the next sequential location is opened. If 
used after a special control character and new value 
sequence, it inserts the new value in the specified 
format into a location, 


a“ 


Circumflex (up-arrow on some terminals) /RETURN: the 
previous location is opened. 


* RET or @(RED 


Asterisk/RETURN or at sign/RETURN: the location 
pointed to by the contents of the opened location is 
opened. 


Right-angle bracket/RETURN: the contents of the open 
location is treated as a branch instruction. The 
effective address of the branch is the next opened 
location. You cannot supply a value (modify the 
Current open location) and close the location with a 
right-angle bracket/RETURN. 


Keywords: 
/ARFF= (CPx, UBY] 
(RSX~LIM-PLUS multiprocessor systems only.) Accesses an 
address relative to the specified processor's I/0 page. The 
Square orackets are required syntax. 


/CPU=CPx 


(RSX-LIM-PLUS multiprocessor systems only.) Accesses an 
address relative to the specified CPU partition. 


/DRV=dd: 
Accesses an address relative to the beginning cf the 
partition that contains the loadable driver for the 


specified device. 
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/KNL 


Accesses the first 32K of Executive memory. 


ear=partition-n: 


-  (RSX-11M sysi 
~- beginning o! 


-/REG=reg ion-na 


 (RSX-11 


/TASK=taskname 


Accesses an address relative to the specified task (the task 
partition). Note that the task must be fixed. 
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After accepting the first input line, OPEN finds the memory location 
to be accessed by using either: 


e The keyword (in a mapped system) 
e The specified address as the actual address 


When /DRV, /PAR, /REG, and /TASK are used, the supplied memory address 
(a virtual address in the partition) is modified by + or - n. The 
absolute address thus formed is used to display the second line shown 
in the command format. In particular, the virtual address (task, 
partition, or kernel) and its contents are displayed. You may then 
enter an optional replacement value, followed by a line terminator. 


On mapped RSX-11M systems, an attempt to specify. an illegal location. 
or access beyond the. limits of the. partition causes. an error. message. . 
You are limited to the specified memory: region (TASK, ~ PAR, or DRV) . 
However, if. you.-da..4 : the command - line, OPEN can - 


access any address of phys nmapped | _RSX- 11M Pes 
any location in physical ee 


3-140.1 


MCR COMMANDS 


OPE (Cont.) 


Examples: 


nee its eee in. oat 


Command Error ueseaqwa: 
OPE -- BYTE ADDRESS 


The address specified as the argument to the OPEN command 
was an odd address. 


An even address’ (for 


£& ~s 7. 
agadress (for exampie, 3 


is legal. An odd 
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OPE -- INPUT I/O ERROR 
In attempting to read the next command, OPEN detected an 
error. 

OPE -- INVALID ADDRESS 


The address specified as an argument by the OPEN command 
referenced a nonexistent memory location, an address outside 
of the specified partition, or an address outside of the 
task's virtual address space. 


OPE -- TASK NOT FIXED 


An attempt was made to open a virtual location in a task. 
Since the task was not fixed, it may or may not have been in 
memory when you issued the OPEN command. This message 
indicates that the task was not in memory. 
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PARTITION DEFINITIONS (NP) 


The PAR command displays a description of each memory partition in the 
system. 


olumns that specify: 


ubpartition (SUB) — 
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Format: 


PAR[TITIONS] 


Examples: 


RSX-11M systems 


> PAR 

TTPAR 
EXCOM1 
EXCOM2 
SYSPAR 
TKNPAR 
DRVPAR 


LDRPAR 
BASIC2 
FCSRES 
TSTPAR 


GEN 


114670 
114624 
114560 
114514 
114450 
114404 
114340 
114240 
114140 
114040 
113240 
113104 
112450 
112404 
112340 
112274 
112230 
112164 
045214 
072740 
074670 
072240 
102350 
074624 
074334 
063724 


00120000 
00160000 
00174500 
00202600 
00212600 
00222600 
00222600 
00224700 
00226100 
00231200 
00245000 
00246300 
00252600 
00253100 
00255600 
00315600 
00355600 
00455600 
00455600 
01151100 
01206700 
01242600 
01302400 
01472500 
01714100 
01773200 


00040000 
00014500 
00006100 
00010000 
00010000 ° 
00030300 
00002100 
00001200 
00003100 
00003000 
00001300 
00004300 
00000300 
00002500 
00040000 
00040000 
00100000 
03322200 
00006200 
00035600 
00020300 
00037600 
00132300 
00131300 
00057100 
00060000 
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MAIN 
MAIN 
MAIN 
MAIN 


(TT13 ) 
(AT.T51) 


-DB: 
-DK: 
-DM: 
-DR: 
-LP: 
-MM: 
-CO: 


RSX-11M-PLUS systems 


SPLPAR 
DRVPAR 


LDRPAR 


TSTPAR 
SECPOL 
GEN 


> PAR 

SYSPAR 
065230 
117767 
117624 
117340 
117274 
117164 
117120 
036314 
116744 
116700 
116634 
116550 
116504 
116440 
116374 
036044 
036504 
117560 
116054 
117514 
117450 
117404 
115454 
073400 
052274 
060774 
037210 
045104 
040240 
043300 
044474 
062254 
061340 
061674 
061774 
063050 
070100 
071114 
037474 
072244 
042100 
037540 
064534 
037724 
070574 


117734 00174400 00010000 


00174400 
00204400 
00216400 
00216400 
00221500 
00226100 
00227400 
00233400 
00236400 
00237500 
00243300 
00300600 
00316400 
00317700 
00321200 
00321300 
00322600 
00356400 
00356400 
00361200 
00421200 
00443200 
00443200 
00534000 
00542600 
00571400 
00620100 
00656200 
00716200 
01007000 
01077600 
01170400 
01230400 
01242500 
01254600 
01313700 
01401400 
01437000 
01474400 
01571100 
01631100 
01715600 
02050500 
02143000 
02340500 
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00010000 
00012000 
00140000 
00003100 
00001300 
00001300 
00004000 
00001600 
00001100 
00003600 
00035300 
00015600 
00001300 
00001300 
00000100 
00001300 
00003200 
00002600 
00002600 
00040000 
00022000 
04734600 
00070600 
00006000 
00003500 
00020100 
00036100 
00026400 
00070600 
00070600 
00070600 
00040000 
00012100 
00012100 
00037100 
00037100 
00035400 
00035400 
00074500 


00026500 


00064500 
00102700 
00033500 
00134300 
00041700 
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MAIN 
TASK <TKTN > 
MAIN 
MAIN 
DRIVER (DB:) 
DRIVER (DK:) 
DRIVER (DS:) 
DRIVER (DM:) 
DRIVER (DX:) 
DRIVER (LP:) 
DRIVER (MM:) 
RW COM !TTCOM ! 
DRIVER (TT:) 
DRIVER (RD:) 
DRIVER (VT:) 
DRIVER (NL:) 
DRIVER (DT:) 
DRIVER (DR:) 
MAIN 
TASK <.«-LDR> 
MAIN 
SEC POOL 
MAIN 
TASK <F1IACP> 
TASK <TT36 > 
RO COM +...EDI+ 
TASK <OMG...> 
TASK <HRC...> 
TASK <RMDEMO> 
TASK <DSOOF1> 
TASK <DSO1FI1> 
TASK <LSTACP> 
TASK <SYSLOG> 
TASK <LPPO > 
TASK <LPPl > 
TASK <BAP2 > 
TASK <BAP] > 
TASK <AT.T36> 
TASK <AT.V3 > 
TASK <EDTT3 > 
TASK <PARV3 > 
TASK <TT47 > 
TASK <EDIT25> 
TASK <TTF6 > 
RW COM !RMSRES! 
TASK <LOGT17> 
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REA 


REASSIGN (P) 
The REASSIGN command reassSigns a task's Logical Unit Numbers’ (LUNs) 
from one physical device unit to another. The reassignments affect 
only the static assignments recorded in the task's image file on disk. 
The command does not affect a memory-resident task. Hence, REASSIGN 
has no effect on the assignments of a currently executing task nor on 
those of a task that is fixed in memory. 
Format: 

REA[SSIGN] taskname lun ddnn: 
taskname 

The name of the task. 
lun 

The Logical Unit Number of the task. 
ddnn: 


The new device unit, which can be a physical, logical, or pseudo 
device. 


Examples: 
>REA TSK1 3 TTO: 
Reassigns LUN 3 of task TSK1 to device TTO:. 
>REA GNRL 2 TTL: 
Reassigns LUN 2 of task GNRL to device TTl:. 
>REA TEST 3 XX: 
Reassigns LUN 3 of task TEST to logical device XxX:. 
Command Error Message: 
REA -- LUN OUT OF RANGE 
An attempt was made to reassign a LUN that was greater’ than 


the maximum number of LUNs allocated to the task when it was 
built. 
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REDIRECT (P) 
The REDIRECT command redirects all I/O requests previously directed to 
one physical device unit to another physical device unit. The 
REDIRECT command is especially useful if I/O units required for a task 
are not working. The command does not affect any I/O requests already 
in the I/O queue. 
You cannot redirect the following device units: 

e The pseudo device TI: (nor can a device be redirected to TI:) 


e An attached device 


e A device unit containing a mounted volume 


In addition, you cannot redirect a pseudo device to itself, nor can 
you redirect a terminal to the null device. 


You can redirect a logged-in terminal to a device other than a 
terminal (except for the null device), but it is not generally 
advisable to do so because terminal I/O would be written to the device 
and that could destroy the boot block. If you do redirect a terminal 
to another type of device, you should redirect the terminal to itself 
before you log out. 
Format: 

RED[IRECT] nddnn:=oddnn: 
nddnn: 


The new device unit to which subsequent requests will be 
directed. 


oddnn: 

The old device unit from which requests have been redirected. 
Example: 

>RED TT3:=TT6: 


Redirects all I/O requests for device TT6: to device MTT3:. 
(RED TT6:=TT6: restores I/O requests for TT6:.) 


Command Error Messages: 
RED -- CIRCULAR REDIRECT ERROR 


The attempt to redirect a device would result in a circular 
list of redirections. 


RED -~ DEVICE NOT REDIRECTABLE 


An attempt was made to redirect a device that cannot be 
redirected. 
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RED 


RED 


RED 


RED 


RED 


RED 


RED 


-- NEW DEVICE NOT KNOWN TO SYSTEM 


The new device specified by the REDIRECT command was not 
known to the system (did not exist in the device tables). 


~- OLD DEVICE ATTACHED 

An attempt was made to redirect an attached device. 
-- OLD DEVICE MOUNTED 

An attempt was made to redirect a mounted device. 
-- OLD DEVICE NOT KNOWN TO SYSTEM 


An attempt was made to redirect an unknown device (the 
device did not exist in the device tables). 


-- PSEUDO DEVICE REDIRECT ERROR 


An attempt was made to redirect one pseudo device to another 
pseudo device. 


-- TI REDIRECT ERROR 


An attempt was made to redirect the pseudo device TI:. This 
device cannot be redirected. 


-- TT REDIRECT ERROR 


An attempt was made to redirect a terminal to the null 
device. This combination is not allowed. 
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REMOVE (P) 

The REMOVE command deletes an entry (a task name) from the System Task 
Directory (STD) and thereby removes the task from the system. The 
removal of a task from the system makes the task unknown to the 
system. This action is the complement of INSTALL. All that remains 
of the task in the system is the task image file. 


REMOVE also checks to see if the task is an initialized CLI. If ‘so, 
REMOVE isSues an error message. 


To remove a task that is currently executing, you must first abort the 
task. 


Format: 

REM[OVE] [ddnn:] taskname 
ddnn: 

The device from which the task was installed. 
taskname 


The name of the task to be removed. 


Example: 
>REM SCAN 
Removes the task named SCAN from the system. The task image 
file is not deleted. 
Notes: 


e If a task that is the object of a REMOVE command is fixed, the 
command unfixes the task and then removes it. 


@ REMOVE cancels all time-based schedule requests for _ the 
specified task. 


@e REMOVE unlinks a task from all ICS/ICR interrupts. 

e REMOVE deallocates all receive-by-reference and receive-data 
packets for the task and detaches all attached regions. (See 
the RSX-11M/M-PLUS Executive Reference Manual.) 

Command Error Message: 
REM -- CLI IN USE 
An attempt was made to remove a CLI that was still active. 


Before a CLI can be removed, its CPB must be eliminated with 
the CLI command. 
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RESUME (NP,P) 

The RESUME command continues execution of a previously suspended task. 
A nonprivileged user can issue the RESUME command only for tasks 
initiated from the issuing terminal. A privileged user can direct the 
RESUME command to any suspended task. 

Format: 


RES[UME] taskname [/TERM=TTnnn:] 


taskname 


The name of the task to be resumed. 


Lus systems. only. ae nei yiieaca: eyword th 
ited from the. specified terminal. os 


Example: 
>RES RX7 
Resumes task RX7. 
Note: 


A task cannot suspend any task other than itself. The RESUME 
command allows such a suspended task to proceed. 


Command Error Message: 
RES -- TASK NOT SUSPENDED 


The task specified in the RESUME command line was not 
suspended. 
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RUN 


The RUN command initiates the execution of a task. The command can 
cause a task to be: 


Run immediately (NP) 


Run at a time increment from now (P) 


Run at a time increment from clock unit synchronization (P) 


Run at an absolute time of day (P) 


Installed, immediately run, and removed on exit (NP) 


All of these options, except install-run-and-remove, are available 
with or without rescheduling. 


Formats: 


RUN has five format variations. 


yee 


Run immediately (nonprivileged option). 


RUN taskname [/UIC=[g,m]] 


taskname 


FULC 


A l- to 6-character task name. 


(Privileged option on multiuser systems only.) The UIC 
under which the task will be requested to run. This UIC 
also determines which files the task can access. 


The UIC has the format [g,m], where g and m_ represent 
the group and member numbers, respectively. Legal group 
and member numbers range from 1 through 377(8). The 
square brackets are required syntax. 


When you use /UIC, RUN locates the task image file in 
the specified UIC (on device SY:) and runs the task from 
that UIC. The specified UIC also becomes the default 
and protection UICs for the task. 


When you do not use /UIC, RUN looks for the task image 
file in the System Task Directory (STD) to see if the 
task is already installed. If RUN finds the task, it 
proceeds to run it. If RUN does not find the task, it 
looks for the file in the UIC (on device SY:) to which 
the terminal requesting the task is set, and then 
installs and runs the task. The terminal's UIC becomes 
the default and protection UICs for the task. 


Si ne 
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Note that on mapped systems, you can request a task _ to 
run that is not in the STD. MCR invokes a catchall task 
to install and run the uninstalled task. See the 
RSX-11M/RSX-11S or RSX-11M-PLUS Release Notes for 
information about the catchall task. 


See the description of /UIC under Format 5 for its use 
by nonprivileged users and tasks. 


Default: the UIC of the terminal that issued the RUN 
command (/UIC is not specified). 


2. Run at a time increment from now (privileged option). 
RUN taskname dtime [/RSI=magu] [/UIC=[g,m] ] 
taskname 
A l- to 6-character task name. 
dtime 


The time at which the task will be initiated in time 


units from command issuance. This time parameter 
consists of two fields: a magnitude field and a units 
field. The parameter is in the form magu where mag is 


the magnitude and u is one of the following time units: 
T; SS; -M, OY He 


The magnitude is the number of units to be clocked. It 
cannot exceed 24 hours in the specified unit and is 
decimal by default. 


The unit fields are T, S, M, and H: 
T 


Ticks. A tick is a clock interrupt. The rate 
at which interrupts occur depends on the type of 
clock installed in the system. For a line 
frequency clock, the tick rate is either 50 or 
60 per second, depending on the line frequency. 
For a programmable clock, a maximum of 1000 
ticks per second is available. The frequency is 
selected at system generation. 


T can be any positive value from 0 through a 
maximum length of 15 bits. 


Seconds. S can be any positive valiue from 0 
through a maximum length of 15 bits. 


Minutes. M can be any positive value from 0 
through 1440(10). 
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Hours. H can be any positive value from 0 
through 24(10). 


/RSI 
The reschedule interval. The format is the same as_ for 
dtime. The reschedule interval specifies how often the 
task is to be rerun. Thus, each time the specified 
interval of time lapses, an initiation request is made 
for the specified task. 
If the magnitude is equal to 0, then the _ reschedule 
interval is set to 1. Specifying /RSI=0H is the same as 
specifying /RSI=1H. 
Note that the CANCEL and REMOVE commands negate the 
effect of this keyword. 
Default: no rescheduling. 

/UIC 


See Format l. 


Run at a time increment from clock unit synchronization 
(privileged option). 


The system determines the task start-time by waiting for the 

first specified time unit (hour, minute, second, tick) to 

increment and then waiting for the specified time to elapse. 
RUN taskname sync [dtime] [/RSI=magu] [UIC=[uic] ] 

taskname 


A 1l- to 6-character task name. 


sync 


Synchronize on the next hour 
Synchronize on the next minute 
Synchronize on the next second 
Synchronize on the next tick 


Hns mo 
1 


dtime 
See Format 2. If present, dtime is added to the 
synchronization unit to produce the actual run time for 
running the task. 

/RSI 
See Format 2. 


/UIC 


See Format l. 
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Run at an absolute time of day (privileged option). 
RUN taskname atime [/RSI=magu] [/UIC=[uic] ] 
taskname 
A 1l- to 6-character task name. 
atime 


Absolute time of day at which to initiate this’ task. 
Input format is hh:mm:ss. 


hh — Hours (decimal assumed) 
mm — Minutes (decimal assumed) 
ss - Seconds (decimal assumed) 
/RSI 
See Format 2. 
/UIC 
See Format l. 
Install, run immediately, and remove on exit. 
RUN [ddnn:][$]filename [/keyword(s) ] 
ddnn: 


The device unit on which the task image file resides. 


Specifies that the file can be found in the System Task 
Directory on device LB: (if ddnn: is not specified). 


The SET /SYSUIC command defines the system directory. 
By convention, the directory is [1,50] on an unmapped 
system and [1,54] on a mapped system. 


If you do not specify $, RUN searches for the task image 
file in the UIC (on device SY:) to which the terminal 
requesting the task is set. (This is similar to Format 


Note that if LB: has been reassigned to another device 
and that device's system UIC contains privileged tasks 
built for another system, your system will crash. 


AW 
| 
~ 
wm 
ns 


MCR COMMANDS 


RUN (Cont.) 


filename 

The name of the task image file to be run. 
Keywords: 

/CKP=option 


Specifies whether or not a task will be 
checkpointable. The options are YES and NO. If 
you specify /CKP=YES (default for checkpointable 
tasks), checkpointing is allowed. If you specify 


/CKP=NO, checkpointing is disabled for the task. 


The /CKP keyword overrides the /CP switch specified 
at task build. 


On systems that support the dynamic allocation of 
checkpoint space, the task image file does not need 
to contain allocated checkpoint space. The 
presence of the /CKP=YES keyword instructs the 
system to allocate checkpoint space for the task 
when required from a checkpoint file. 


/CMD="command-line" 


Passes the specified command line to the task for 
processing. The command line must begin with the 
task's acronym and it must be valid for the task 
(for example, if the task being installed is MAC, 
"command-line" must be a valid MACRO-11 command 
line) Or a syntax error will occur. When the task 
has finished executing the command line, the task 
is removed. 


/EST=option 


Specifies whether or not a task will wait for 
spawned tasks to complete and for RUN to emit exit 
status. The options are YES and NO. If you 
specify /EST=YES, the parent task waits for any 
task it spawns to complete and for RUN to emit exit 
Status before continuing. If you specify /EST=NO, 
the parent task does not wait for exit status from 
RUN; as soon as the spawned task begins running, 
the parent task continues executing. 


Default: /EST=YES; parent tasks do not continue 
until RUN emits exit status. 


/INC=size 


Increments the address space allocated to ae task 
that runs in a system-controlled partition. The 
variable size is the number of additional words of 
address space to allocate. The increment is 
usually expressed in octal, but can also be 
expressed in decimal by appending a period. 


3-155 April 1983 


RUN (Cont.) 


MCR COMMANDS 


This keyword overrides the EXTTSK or PAR_ option 
used at task-build time. Tasks that specify the 
size of the partition in which they are running use 
this keyword to identify how much dynamic space 
they may allocate to symbol tables or buffers. 
Tasks such as MAC, TKB, VFY, and AT. use the space 
from the end of the task image to the end of their 
address space as dynamic memory. In effect, the 
/INC keyword defines the number of words in this 
dynamic region. 


On RSX-11M/M-PLUS systems, you cannot extend a task 


that uses memory-resident overlays. (See the 


RSX-11M/M-PLUS Task Builder Manual.) 


Default: The size specified at task-build time. 


/I1OP=option 


Specifies that a privileged task can overmap' the 
I/O page. The options are YES and NO. If you 
specify /IOP=YES, RUN assumes that the task will 
overmap the I/0 page (APR7) and, if the task is 
larger than 8K words, issues a warning message. If 
you specify /IOP=NO, RUN assumes that the task does 
not need to use the I/O page. No warning message 
is issued. 


/IOP complements the Task Builder /IP switch. 
Specifying /IP informs RUN that the task is 
intentionally overmapping the I/0 page. 


Default: /IOP=YES. 


/PAR=parname 


Specifies the partition in which the task is to be 
installed. 


Default: Partition specified at task-build time. 


/PMD=option 


Requests a Postmortem Dump when the task aborts. 
The options are YES and NO. If you specify 
/PMD=YES, a Postmortem Dump is requested for the 
task it it aborts because of an SST error 
condition. If you specify /PMD=NO, no dump is 
requested at SST abort time. 


To generate a dump, the Postmortem Dump task PMD... 
must be installed in the system. This keyword 
overrides the /PM switch specified at task-buil 

time, 


Default: Specified at task-build time. 
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/PRI=number 


(Privileged keyword.) Specifies the priority of the 
task. The value range is 1 through 250(10), where 
250 is the highest priority. Standard number 
conventions apply: octal by default, decimal if 
followed by a period. (This keyword is ignored if 
specified by a nonprivileged user.) 


Default: /PRI=50. 


/SLV=option 


Specifies the slave status of the task. The two 
options are YES and NO. If /SLV=YES, data sent to 
the installed task is marked with the TI: of the 
sending task. When the installed task receives the 
data, the system sets the task's TI: to that 
associated with the data. This keyword overrides 
the /SL switch specified at task build. 


T£ /SLV=NO, the TI: of the task does not change 
when receiving data. 


Default: Specified at task-build time. 


/TASK=taskname 


Specifies the name the task will use while it is 
running. This name is a temporary assignment only. 
If taskname is not found in the STD, MCR names it 
TTnn by default, where nn is the unit number of the 
requesting terminal. 


“you. can “specify he tine aipit: ins minutes” (M) eS 
“seconds (S)z Mis the default. whe: “number of: time 
2 anes. any” can be octal (the default) ‘or decimal if 

followed by a Perfod ‘The maximum | value allowed iS. 
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/UIC=[g,m] 


Specifies the UIC under which the task will be 
requested to run. The square brackets are required 
syntax. 


If you specify a UIC, the UIC becomes the default 
UIC for the task. However, your protection UIC 
becomes the protection UIC for the task. If you do 
not specify a UIC, your default and protection UICs 
become the default and protection UICs for the 
task. (See the previous description of /UIC for 
the effects for privileged users and tasks.) 


Default: the UIC of the terminal that issues’ the 
RUN command. 


Examples: 


>RUN TR7 15M 


Runs task TR7 15 minutes from the time the command was 
issued. 


>RUN XKE 15M/RSI=90S/UIC=[3,1] 


Runs task XKE 15 minutes from the time the command was 
issued, rescheduling it every 90 seconds, with a UIC of 
ee gan) 


>RUN DK2:SMAC 


Notes: 


Runs the task in file DK2:MAC.TSK from the system directory. 
The task is automatically installed, run, and removed on 
exit. 


If the command requests the task to run immediately (Format 
1), it establishes the terminal from which the task was 
initiated as the pseudo device TI:. For Formats 2, 3, and 4, 
the system establishes the issuing terminal as the pseudo 
device CO:. 


A run-immediately command (Format 1), if terminated with an 
ESCape character instead of a RETURN, echoes the default 
prompt when the requested task exits and not when MCR has 
finished initiating the task. This facility enables you to 
determine when a task that iS not producing output on a 
terminal has exited. 


The install-run-remove format (Format 5) also establishes’ the 
terminal from which the command was issued as the pseudo 
device TI: and causes the default prompt to be displayed on 
Tie when the task exits. This form of the command is 
especially useful when the space available in the dynamic 
storage region (pool) is low because the memory necessary for 
a Task Control Block (TCB) returns to pool when the task 


eyits. 
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Command Error Messages: 
RUN ~-- INVALID TIME PARAMETER 
A specified time field was incorrect. 
RUN -- TASK BEING ABORTED 
A request for the execution of a task was made, but the task 


was being aborted either because of an unrecoverable error 
or an abort command or directive issued by a user. 
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SAVE (P) 


The SAVE command copies the current RSX-11M/M-PLUS system image (the 
contents of main memory) into the system image file from which the 
current image was booted. (The system image file is a special task 
image file named, by convention, RSX11M.SYS.) The command saves the 
image so that a hardware bootstrap or the BOOT command can later be 
used to reload and restart it. 


On RSX-11M, the system image cannot be greater than 124K; on 
RSX-1LIM-PLUS, there is no size restriction. The size of the system 
image file determines the maximum size that can be _ saved on 
RSX-11M-PLUS, but there are other restrictions on the system image 
file: it must be contiguous and it must be large enough to contain 
all of secondary pool. (SAVE saves secondary pool because prototype 
Task Control Blocks - TCBs - are contained in it.) 


All RSX-11M/M-PLUS system images reside on a file-structured volume as 
a specially formatted task image: the image does not have a task 
header. There may be more than one system image on a volume (for 
example, a program development system and a production or test 
system), and nonprivileged tasks can be installed in several system 
images at the same time. 


To determine the minimum size for a system image file, compute the 
formula of four times the size plus two (4*SYSIZ+2). For example: 


28K requires 114. blocks 

32K requires 130. blocks 
124K requires 498. blocks 
256K requires 1026. blocks 


You can save system images on any of the following devices: 


RSX-11M systems RSX-11M-PLUS systems 
RLO1/02 RD51 RLO1/02 RP02/03 
RKO5 RP02/03 RKO5 RP04/05/06 
RK06/07 RP04/05/06 RK06/07 RPO7 
RM02/03/05/80 RX01/02 RM02/03/05/80 RD51 

RPO7 RX50 RA60 RX50 

RA60 RS03/04 RA80/81 ML11 
RA80/81 DECtape RC25 

RC25 ML11 
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To successfully save a system, the SAVE command requires that: 


2. Error logging is not active. 

3. All tasks must be installed from LB:. 

4. No checkpoint files are active. 

5. No volumes except the load device are mounted. 

6. The load device can be successfully dismounted. 

7. No tasks have outstanding I/0. 

8. No tasks are connected to interrupts. 

9. All drivers, active tasks, fixed tasks and, on RSX-11M-PLUS 
systems, all loaded commons and secondary pool reside within 


the amount of main memory that SAVE will write to the system 
image file. 


An error is reported if any of these requirements are not met. 


SAVE is active when the memory-resident system image is copied to 
disk. Because of this, VMR considers SAVE to be an active task in the 
system image. This is correct because SAVE is the task that starts 
the system after a boot. 


The Executive references the file images of installed tasks by 
physical addresses (Logical Block Numbers, or LBNs). A saved system 
does not always retain the physical disk addresses of installed tasks. 
For example, the Disk Save and Compress Utility Program (DSC) can 
compress and copy a disk containing a saved system, thus moving the 
task files to different physical locations. Therefore, SAVE converts 
the LBNs of all installed tasks into file identifications and _ stores 
these in the TCBs. Since the TCB entries contain task file 
identifications rather than LBNs after a system save, the system can 
function normally when it is rebooted even if LBNs have changed in the 
meantime. 
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Upon system rebooting, SAVE reopens the task file and stores the new 
LBN of the task in the TCB. If a task has been deleted, the system 
cannot open the task file when the system is rebooted. In this case, 
the system automatically removes the task's TCB from the STD. 


When the bootstrap block is written, the physical disk-block address 
of the system image file is stored with it. However, the file can be 
deleted. If there is file system activity, the blocks’ previously 
allocated to the system image may be reallocated to another file. A 
subsequent bootstrap that uses the boot block could possibly cause 
random data to be loaded. 


Upon rebooting a saved system, SAVE: 
e Selects the system clock 
e If the last memory partition is system-controlled, sizes 
memory and extends the partition so that it uses all available 
memory 


e On multiuser protection systems, validates that the boot 
device is not allocated and then sets it public 


e Sets the context of the console terminal as logged in, 
privileged, and nonslaved 


Sizes the boot device (RSX-11M-PLUS systems) 


@e Outputs a system identification message 
e Redirects all pseudo devices to the boot device 
e Mounts the system disk 
e Initiates the file [1,2]STARTUP.CMD on the booted device 
Format: 
SAV[E] [/keyword(s) ] 
Keywords: 
/WB 
Indicates that a hardware boot block pointing to the system 
image is to be written to the system device. The new boot 
block points to the file that is saved with the SAVE 
command. Thus, on the next hardware bootstrap, this saved 
file will be loaded. If the command line omits the /WB 


keyword, the boot block still points to the prior system 
image, which may have been overwritten. 
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/MOU="String" 


Automatically issues a MOUNT command at system startup to 
mount the system disk. 


The MOUNT command line ("String") that you specify must be 
enclosed within quotes and must be in the proper format 
(that is, including all necessary slashes (/) or equal signs 
(=)J% Note that SAVE does not check the syntax of the 
string. 


/SFILE="filespec" 


Automatically initiates an indirect command file 
({1,2]STARTUP.CMD) on the boot device at system startup. 
This keyword allows you to specify another indirect command 
file. 


The command file you specify must be enclosed within quotes. 
Note that SAVE does not check the syntax of filespec. 


Example: 


>SAV 


The current status of the system is saved on the system 
disk. System changes made by the REDIRECT command or other 
MCR commands are also saved with the system image that is 
resident in main memory. 


Command Error Messages (RSX-11M-PLUS-only messages are described 
last): 


SAV -- BAD TASK FILE VBN, TASK REMOVED - taskname 


SAVE removed the specified task because it contained a ad 
virtual block number (VBN) in its file header. The task 
image file has probably been corrupted. 
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SAV 


SAV 


SAV 


SAV 


SAV -- BOOTED DEVICE'S DRIVER NOT LOADED 

VMR has been used to unload the driver for the system 
(booted) disk. Using another system, use VMR to load the 
driver and then reboot the system. 


-~- BOOTED DEVICE NOT IN SYSTEM - dd nnn mmmmmm 


When the system was booted, SAVE could not find the booted 
device (device name dd, physical unit number nnn, CSR 
mmmmmm) in the system data structures. For example, the 
system was booted from DB3:, but the system data structures 
include only DBO: and DBI1:. 


-- CANNOT FIND HOME BLOCK 


SAV could not find the device's home block when searching 
for it or, on RSX-11M-PLUS systems, an error occurred while 
SAV was attempting to read the home block. 


-- CHECKPOINT FILE STILL IN USE ON ddnn: 
The system cannot be saved because a checkpoint file on the 
specified device is still active. Deallocate the checkpoint 
file (see the ACS command) and reenter the SAVE command 
line. 


me OTe REDIRECTED TO CO: 


-(RSX-11M systems” only. y The console: output driver is active. 
If it is not active, the system. may be corrupted. You can 


Be use the OPEN command to redirect. GOs: to. the terminal from 


SAV 


SAV 


which you are running ‘SAVE. 
-- COMMON, DRIVER OR TASK ABOVE SYSTEM IMAGE FILE LIMIT 


A system cannot be saved if addresses for a memory-resident 
structure are higher than the highest address of main memory 
written to the system image file. Use the PARTITION 
DEFINITIONS command (PAR) to determine the cause of the 
problem. This includes the running task image of SAVE. 


-- DISMOUNT COMPLETE FOR ddnn: 
This is an informational message. The message indicates 


that TKTN is not installed in the running system. If the 
load device is mounted when SAVE starts, SAVE attempts’ to 


dismount it. Since TKTN is’ not installed, the dismount 
complete message from DMO is not displayed on the _ console 
terminal. As a substitute, SAVE writes this message to the 


terminal. 
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SAV -- ERROR ATTEMPTING TO DISMOUNT ddnn: 


If the load device is mounted when SAVE is initiated, SAVE 
issues a DISMOUNT command to MCR when the save operation is 
complete. This message indicates that the dismount 
operation was not successful. The system may be usable, but 
it is recommended that you reboot and issue a DISMOUNT 
command. 


SAV -- ERROR LOGGING STILL ACTIVE 


A system cannot be saved while error logging is active. 
Disable error logging and reenter the SAVE command line. 


SAV -- INDEX FILE HEADER CHECKSUM ERROR 


While rebooting a saved system, SAVE detected a checksum 
error in the file header of the index file. The error 
causes the system to halt. The disk has’ probably been 
corrupted. 


SAV -- INDEX FILE HEADER READ ERROR 
While rebooting a saved system, SAVE detected an error in 
the file header of the index file. The error causes the 
system to halt. 

SAV -- LABEL BLOCK I/O ERROR 


In attempting to save the system image, SAVE wrote the 
transfer address in the label block of the system image 
file. An error occurred during this write attempt. The 
disk could be corrupted. 


SAV -- MCR IS NOT INSTALLED 


When a system is booted, SAVE uses MCR to mount the system 
disk. Use VMR to install the MCR... task. 


SAV -- MUST BE RUN FROM TERMINAL CO: 
SAVE is not being run from the terminal to which the pseudo 
device CO: is redirected. (This is not a requirement on an 
RSX-11M-PLUS system.) 

SAV -- NO POOL SPACE 
There is not enough space in pool to contain checkpoint 


information when SAVE tries to force resident read/write 
commons to their file images. 
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SAV -- NOT A VALID SAVE DEVICE 


An attempt was made to save a system on a device that is not 
part of the system I/O data structures (this generally 
implies that SSYSIZ+2 and SSYSIZ+6 are corrupted) or SAVE 
does not support the device. 


SAV -- OPEN FILE(S) ON ddnn: 


There are open files on ddnn:. Ensure that the Queue 
Manager is stopped. 


SAV -- SYSTEM MAY NOT BOOT CORRECTLY 


The file [system-uic]SAV.TSK was not found on the _ boot 
device. If SAVE must be checkpointed to redirect and mount 
the booted device, the system disk will be overwritten, 
causing unpredictable results. 


SAV -- SYSTEM MAY NOT WORK —- LARGER THAN MAIN MEMORY 


This message indicates that the booted system has less main 
memory than the saved system image file and that a structure 
resident in the system image file is completely or partially 
absent in the booted system. If the system can run without 
the structure, the UNLOAD and UNFIX commands can be used to 
remove the nonexistent structures. 


SAV -- $SYSIZ DOES NOT POINT AT SYSTEM IMAGE FILE 


SAVE determines the location of the system image file on the 
system disk by examining the locations near the Executive 
label S$SYSIZ. SAVE then makes several validation checks on 
that file. If those checks fail, SAVE does not write to the 
disk on the assumption that it could corrupt the disk by 
writing to something that is not a system image file. The 
system image or the system image file has been corrupted. 
Examine several locations after SSYSIZ and then reboot. 


SAV -- TASK ACTIVE IN ANOTHER SYSTEM, TASK REMOVED —- taskname 
The task is installed in another system as well as in the 
booted system. Since the task is active and mapped to 


dynamic regions in the other system, it cannot be run in the 
booted system. 
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-- TASK FILE DELETED, TASK REMOVED - taskname 


While rebooting a saved system, a file identification that 
appears in the Task Control Biock (TCB) could not be found 
in the index file on the boot device. This indicates that 
the file has been deleted. 


-- TASK FILE HEADER ERROR, TASK REMOVED - taskname 


When SAVE read the task header to restore the LBN of the 
task file, the checksum was bad or there was a file number 
mismatch. Therefore, the task was removed. 


-- TASK FILE HEADER READ ERROR, TASK REMOVED - taskname 


SAVE removed the specified task because it could not read 
the task's file header. 


-- TASK FILE HEADER WRITE ERROR, TASK REMOVED - taskname 


When SAVE attempted to reassign the LUNs of the task or _ to 
rewrite a mapping window PCB address, it could not 
successfully rewrite the task header. Therefore, the task 
was removed. 


-- TASK HEADER READ ERROR 


SAVE detected an I/O error while reading in a task header to 
write the file identification into the TCB. This error 
causes the system to halt. 


-- TASK HEADER READ ERROR, TASK REMOVED —- taskname 
SAVE detected an I/O error while reading in a task header to 
reassign LUNS or to remap the mapping windows. Therefore, 
the task was removed. 
-- TASK LABEL BLOCK READ ERROR, TASK REMOVED - taskname 
When SAVE attempted to reassign the LUNs of the task to’ the 
current system, the task's label block could not be read 
(the label block contains the static LUN assignments). 
Therefore, the task was removed. 


-- TASK TOO BIG FOR PARTITION, TASK REMOVED - taskname 


The current CPU has less memory than the system image file. 
This message indicates that the last partition has 
contracted such that the indicated task cannot fit into it, 
even if everything else is removed from the partition. 


-- TASK taskname HAS OUTSTANDING I/0 


A system cannot be saved if a task is waiting for I/O to 
complete. 
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SAV 


SAV 


SAV 


SAV 


SAV 


SAV 


-- TASK taskname IS ACTIVE AND CHECKPOINTED 


You cannot save a system if it contains an active and 
checkpointed task. This restriction prevents a possible 
system crash because, if the task was installed in another 
system image file, the task image could be corrupted when 
the task was run in the second system. 


-- TASK taskname IS CONNECTED TO AN INTERRUPT VECTOR 


Disconnect the task from the interrupt vector or abort it, 
and reenter the SAVE command line. 


-- TASK taskname NOT INSTALLED FROM AN LB: 


All tasks must be installed from an_ LB:. Use the TAS 
command to determine which tasks are not. Reenter the SAVE 
command line after removing the tasks or installing them 
from an LB:. 


-- VOLUME STILL MOUNTED ON ddnn: 


The volume on device ddnn: was still mounted when the SAVE 
command line was issued. A system cannot be saved with 
volumes mounted. Dismount the volumes and reenter the SAVE 
command line. T& necessary, use the DEVICES command to 
determine which volumes are mounted. 


-- VOLUME STRUCTURE NOT SUPPORTED 


While rebooting a saved system, SAVE determined from the 
disk's home block that the disk's structure is not Supported 
by the current version of RSX-11M/M-PLUS. This error causes 
the system to halt. 


-- (WARNING) NONEXISTENT LUN ASSIGNMENT FOR TASK taskname 


The physical device to which SAVE was attempting to reassign 
a LUN does not exist in the booted system. This condition 
is resolved if the task performs a run-time assignment’ to 
the LUN; otherwise, the task will encounter an error 
condition when it attempts to use the LUN. 


WiC ea ee 
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SET (NP,P) 


The SET command dynamically changes characteristics of and displays 
information about the system, tasks, and devices. 


Nonprivileged users can change the characteristics of their own 
terminals (pseudo device TI:) and any privately allocated device. 
Privileged users can change the characteristics of any device and also 
of any task and of the system. All users can display information 
about any device or task or about the system. 


The following two lists describe all the available options for 
nonprivileged and privileged users. 


Nonprivileged options: 


e Establish characteristics for the issuing terminal (TI:) and 
for private devices 


e Set the default UIC for the issuing terminal 


e Display the status (determined by the keyword specified) of 
all terminals and other devices 


e Display statistics about system dynamic memory 
Privileged options: 

e Establish characteristics for any device in the system 

e Establish the default UIC for any terminal in the system 

e Establish the default UIC for DECnet-related tasks 


e Eotabiien jee eee ULC. 


e Set a device to public status so that any system user can 
access the device 


e Create partitions and subpartitions 

e Move the top boundary of a partition 

e Add space to the dynamic core pool 

e Modify the pool limit parameters used by the Pool Monitor Task 


@ Enable write check on devices that support it 


a= LPO 
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e Specify the maximum number of I/O packets to be  preallocated 
to optimize I/O performance 


e Specify the maximum size to which a task can extend itself. 


e Enable or disable the ability to log in on terminals in a 
multiuser protection system 


Improper use of the SET command from a privileged terminal can result 
in a Situation in which privileged user input will not be accepted. 
Avoid the following two situations: 


e All privileged terminals in the system are slaved and cannot 
enter unsolicited input to MCR, and _ logins are disabled. 
Nonprivileged terminals cannot enter privileged commands’ and 
therefore cannot reset the privileged terminals to be 
nonslaved. See the description of the /SLAVE keyword in the 
"Keywords" section in the following pages. 


e The buffer length of all the nonslaved, privileged terminals 
is shorter than 14 bytes on RSX-11M and shorter than 2 bytes 
on RSX-11M-PLUS. The terminal buffer is then too small for a 
privileged user to enter many important commands required to 
continue system operation or to alter the status of other 
terminals. See the description of the /BUF keyword in the 
"Keywords" section in the following pages. 


Also, some keywords (/ABAUD, /EBC, /FDX, /HFILL, /HHT, /LINES, /RPA, 
/TERM, /TYPEAHEAD, /VFILL, and /WRAP) are only supported with the 
full-duplex terminal driver. The full-duplex terminal driver is a 
system generation option in RSX-11M systems but is always included in 
RSX-11M-PLUS systems. Note that if you select the full-duplex driver 
on RSX-11M, you must also select the get/set multiple characteristics 
option to display or set any terminal-related characteristics. 


Format: 
SET /keyword=values 


Only one keyword per command line is permitted. You can prefix 
most keywords with NO to negate or disable the function of the 
keyword. (Exceptions are noted in Table 3-3. The system returns 
a syntax error message whenever NO precedes one of these 
keywords.) The keywords are described in alphabetical order 
following Table 3-3. 
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Table 3-3 
SET Keywords 


Keywords 


Device 
Characteristics 


/{NO]ABAUD[=TTnn:] 


/{(NO]BRO[=TTnn:] 
/BUF=ddnn: [size] 
/CLI=TTnn: [cli] 
/(NO]CRT[=TTnn:] 
/DCL[=TTnn: ] 
/{NOJEBC([=TTnn:] 
/(NO]ECHO[=TTnn: ] 
/(NO]ESCSEQ[=TTnn:] 
/(NO] FDX[=TTnn: ] 
/(NO] FORMFEED[(=TTnn: ] 
/HFILL=TTnn: [value] 
/{NO]HHT[=TTnn:] 
/{NO] HOLD[=TTnn:] 
/LINES=TTnn: [value] 
/(NO] LOWER [=ddnn: ] 
/MCR[=TTnn:] 


/(NO]OPT=[ddnn:opttyp: fairness-count] 
(RSX-11M-PLUS systems only) 


| | /[NO]OVLP[=ccn] 
(RSX-11M-PLUS systems only) 


/{NO]PRIV[=TTnn: } 
/(NO] PUB[=ddnn:] 


/{NO]REMOTE[=TTnn: [speed] ] 


(continued on next page) 
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Table 3-3 (Cont.) 
SET Keywords 


Keywords 


/{NO]RPA[=TTnn:] 


/{NO]SERIAL[=TTnn:] 


babe ° 4 


(RSX-11M-PLUS systems only) 


/(NO] SLAVE [=TTnn:] 
/SPEED=TTnn: [recv:xmit] 


/TERM=TTnn: [value] 
/UIC [=[uic] [:TTnn:] ] 


/{NO] VFILL[=TTnn:] 


| 
/ [NO] TYPEAHEAD [=TTnn: [size] ] 
/ [NO] WCHK [=ddnn:] 


/{NO]WRAP[=TTnn:] 


Enable/Disable / [NO] LOGON 
Login 

(privileged 

options) 


I/O Packet /MAXPKT [=n] 


Library or /LIBUIC{[=[uic] ] 
System UICS (RSX-1LI1M-PLUS systems only) 


/NETUIC[=[uic]] 
/SYSUIC [=[uic] ] 


Memory /MAIN=pname[:base:size:type] 
Allocation (RSX-11M systems; 
(see notes synonym for /PAR on RSX-11M-PLUS 
before error systems;) 
messages) 

/NOMAIN=pname 


/MAXEXT [=size] 


/NOCEX 
(RSX-11M-PLUS systems only) 


/PAR=pname[:base:size[:type] ] 
(RSX-11M-PLUS systems only) 


(continued on next page) 
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Table 3-3 (Cont.) 
SET Keywords 


Type | Keywords 
/NOPAR=pname 
(RSX-1L1M-PLUS systems only) 


/POOL[=top] 


/SECPOL 
(RSX-LIM-PLUS systems only) 


/SUB=mname :sname[:base:size] 
(RSX-11IM systems only) 


/NOSUB=mname :sname 
(RSX-11M systems only) 


/TOP 


Pool /PLCTL[=[high] [: [low] [: [frz] [: [basep]]]]} 
Monitor Task 


Output Task 


_ : 


System | /RNDC[=nn] | 
Tuning | | 
/RNDH [=nn] 
| /RNDL [=nn] | 
/SWPC [=nn] 
/SWPR [=nn] 


Keywords: 


/ABAUD [=TTnn:] 


(Full-duplex terminal driver only.) Enables autobaud 
detection for the remote dial-up line for the specified 
terminal. The terminal driver samples the line's first 
input character, tries to determine the incoming baud rate, 
and sets the interface speed accordingly. 


A nonprivileged user can display all the terminals that have 
autobaud detection enabled, but only a privileged user can 
enable the option for a specific terminal. 


When you omit =TTnn:, the system displays all the terminals 
with autobaud detection. 
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Examples: D pad 


>SET /ABAUD=TT1O: 
Enables autobaud detection for TT10:. 


>SET /ABAUD 
ABAUD=TT4: 
ABAUD=TT5: 
ABAUD=TT6: 
ABAUD=TT10: 


Displays all the terminals that have autobaud 
detection enabled. 


/NOABAUD[=TTnn:] 


(Full-duplex terminal driver only.) Disables autobaud 
detection for the specified terminal. The terminal driver 
does not attempt to determine the incoming baud rate for the 
remote dial-up line. 


A nonprivileged user can display all the terminals that have 
had autobaud detection disabled, but only a privileged user 
can disable the option for a specific terminal. 


When you omit =TTnn:, the system displays all the terminals 
that do not have autobaud detection. 


Examples: 
>SET /NOABAUD=TT6: 
Disables autobaud detection for TT6:. 

>SET /NOABAUD 

NOABAUD=CO0: 

NOABAUD=TT4: 

NOABAUD=TT6: 

NOABAUD=TT?7: 


Displays all the terminals that do not have 
autobaud detection enabled. 


/BRO[=TTnn:] 
Enables the broadcast option for the specified terminal. 
The terminal can receive messages sent from other terminals 
with the BROADCAST command. 


When you omit =TTnn:, the system displays all the terminals 
that can receive messages. 


/BRO is valid only on systems that have multi-CLI support. 
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Examples: 
>SET /BRO=TT7: 
Enables the broadcast option for TT7:. 


>SET /BRO 
BRO=CO0: 
BRO=TT4: 
BRO=TTS5: 
BRO=TT6: 
BRO=TT7: 


Displays all the terminals that have the broadcast 
option enabled. . 


/NOBRO[=TTnn:] 


Disables the broadcast option for the specified terminal. 
The terminal cannot receive messages sent from other 
terminals. The terminal also cannot receive messages’ from 
the SHUTUP program until the last five minutes before system 
shutdown. It is recommended that you not use the /NOBRO 
keyword unless you need to because you could miss important 
messages. 


When you omit =TTnn:, the system displays all the terminals 
that cannot receive messages. 


/NOBRO is valid only on systems that have multi-CLI support. 


Examples: 


>SET /NOBRO=TT4: 
Disables the broadcast option for TT4:. 


>SET /NOBRO 
NOBRO=TT4: 
NOBRO=TT10: 


Displays all the terminals that have the broadcast 
option disabled. 


/BUF=ddnn: [size] 


Sets or displays the default buffer size of the specified 
device. A nonprivileged user can display the buffer size of 
any device but can only set the buffer size of TI:. A 
privileged user can set the buffer size for any device. 


The specified size must be greater than 0 and less than or 
equal to 255(10). If ddnn: is a terminal, the specified 
size must be greater than 15(10) and less than or equal to 
255(10). /BUF is particularly useful for defining line 
printer width (80 or 132 decimal columns) and the maximum 
number of characters allowed in a command line. 
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When you omit size, the system displays the buffer size of 
the specified device. 


Example: 


>SET /BUF=LP0: 
BUF=LP0:132. 


Displays the current buffer size of LPO:. 
>SET /BUF=TT1:40. 
Sets TTl: buffer size to 40(10). 
/CLI=TTnn: [cli] 


Defines the default command line interpreter (CLI) for’ the 
specified terminal. The CLI can be MCR, DCL, or a 
user-written CLI. (However, note that before a CLI can be 
used, it must be installed with the INSTALL /CLI=YES 
command.) 


A nonprivileged user can display the default CLI for any 
terminal but can only set the CLI for TI:. A privileged 
user can set the default CLI for any terminal. 


When you omit cli, the system displays the current default 
CLI for the specified terminal. 


/CLI is valid only on systems that have multi-CLI support. 
Examples: 


>SET /CLI=TI: 
CLI=TI:MCR 


Displays the current default CLI for TI:. 


>SET /CLI=TI:ACLI 
Sets the default CLI for TI: to ACLI. 


/COLOG 


This keyword is documented with the Console Output Task 
(COT) in the RSX-11M/M-PLUS System Management Guide. 


/7CRT[=TTnn: ] 


Defines the specified terminal as a Cathode Ray Tube (CRT) 
and enables the backwards deletion option. Typing the 
RUBOUT or DELETE key moves the printing position one space 
to the left and erases any character displayed in that 
position. 


A nonprivileged user can display all terminals defined as 


CRTs but can only define TI: as a CRT. A privileged user 
can define any terminal as a CRT. 
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When you omit =TTnn:, the system displays all the terminals 
that are defined as CRTs. 


Examples: 
>SET /CRT=TT3: 


Enables the backwards deletion option for terminal 
TSts 


>SET /CRT 
CRI=TT3: 
CRT=TT4: 


Displays all the terminals that have the backwards 
deletion option enabled. 


/NOCRT[=TTnn:] 


Deletes the CRT status of the specified terminal and 
disables the backwards deletion option. 


A nonprivileged user can display all the terminals not 
defined as CRTs but can only delete CRT status for TI:. A 
privileged user can delete CRT status for any terminal. 


When you omit =TTn:, the system displays all the terminals 
that are not defined as CRTs. 


Examples: 
>SET /NOCRT=TT4: 


Disables the backwards deletion option for TT4: 


>SET /NOCRT 
NOCRT=TTO: 
NOCRT=TT1: 
NOCRT=TT2: 
NOCRT=TT4: 


Displays all the terminals that have the backwards 
deletion option disabled. 


/DCL[=TTnn:] 


Enables the recognition of DIGITAL Command Language (DCL) 
commands at the specified terminal. Commands entered in 
response to the default prompt are submitted to DCL. 


To return a terminal to MCR command recognition, type the 
DCL command SET TERMINAL MCR. 


A nonprivileged user can display all the terminals that 
recognize DCL commands but can only enable DCL recognition 
for TI:. A privileged user can enable DCL command 
recognition for any terminal. 
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When you omit =TTnn:, the system displays all the terminals 
that have DCL command recognition enabled. 


/DCL is valid only on systems that have multi-CLI support. 
Examples: 

>SET /DCL=TT3: 

Enables DCL command recognition for TT3:. 

>SET /DCL 

DCL=TT3: 

DCL=TT7: 

DCL=TT10: 

DCL=TT12: 


Displays all the terminals that recognize DCL 
commands. 


/EBC[=TTnn: ] 
(Full-duplex terminal driver only.) Enables’ the 8—-bit 
character option. The terminal driver passes all eight bits 


of the input characters to the specified terminal. 


A nonprivileged user can display all terminals that have the 
option enabled but can only enable the EBC option for TI:. 
A privileged user can enable the EBC option for any 
terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have the EBC option enabled. 


Examples: 
>SET /EBC=TT3: 
Enables the EBC option for terminal TT3:. 
>SET /EBC 
EBC=TT3: 
EBC=TT5: 


Displays all the terminals that have the _ EBC 
option enabled. 


/NOEBC[=TTnn: ] 
(Full-duplex terminal driver only.) Disables the 8-bit 
character option. Before passing the input characters to 
the device, the terminal driver removes the parity bits. 
A nonprivileged user can display all terminals that have the 


option disabled but can only disable the EBC option for TI:. 
A privileged user can disable EBC for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have the EBC option disabled. 
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Examples: 


>SET /NOEBC 
NOEBC=TTO: 
NOEBC=TT1: 
NOEBC=TT2: 
NOEBC=TT4: 


Displays all terminals that have the EBC option 
disabled. 


>SET /NOEBC=TT3: 
Disables the EBC option for terminal TT3:. 
/ECHO[=TTnn:] 


Instructs the terminal driver to display each character 
typed on the specified terminal. 


A nonprivileged user can display all terminals that echo 
typed characters but can only enable the echo option for 
TI:. A privileged user can enable the echo option for any 
terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have the echo option enabled. 


Examples: 
>SET /ECHO=TT3: 
Enables the echo option for terminal TT3:. 
‘>SET /ECHO 
ECHO=TT1: 
ECHO=TT3: 


Displays all the terminals that have the echo 
option enabled. 


/NOECHO[=TTnn:] 


Instructs the terminal driver to inhibit the display of all 
input characters typed on the Speer ted terminal. 


“Note that on. -RSX-11M- systems with ‘the half- —duplex “terminal: 
“driver, - unsolicited i put alw fly a 
‘Solicited by a task is | 


A nonprivileged user can display all oral nate that do not 
echo typed characters but can only disable the echo option 
for TI:. A privileged user can disable the echo option for 
any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have the echo option disabled. 


3-180 


MCR COMMANDS 


SET (Cont.) 


Examples: 


>SET /NOECHO 
NOECHO=TTO: 
NOECHO=TT2: 
NOECHO=TT4: 


Displays all the terminals that do not echo typed 
characters. 


>SET /NOECHO=TT3: 
Disables the echo option for terminal TT3:. 
/ESCSEQ[{=TTnn: ] 


Enables the recognition of escape sequences from the 
specified terminal. The terminal driver treats the ESC 
character as the beginning of an escape sequence rather than 
as a line terminator. See the RSX-11M/M-PLUS I/O Drivers 
Reference Manual for further information about escape 
sequences, 


A nonprivileged user can display all terminals that can send 
and receive escape sequences but can only enable escape 
sequence recognition for TI:. A privileged user can enable 
escape sequence recognition for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that can send and receive escape sequences. 


Examples: 
>SET /ESCSEQ=TT3: 


Establishes TT3: as a terminal that can send and 
receive escape sequences. 


>SET /ESCSEQ 
ESCSEQ=TT3: 
ESCSEQ=TTS5: 
ESCSEQ=TT10: 


Displays all the terminals that can send and 
receive escape sequences. 


/NOESCSEQ[=TTnn: ] 


Disables the recognition of escape sequences at the 
specified terminal. 


A nonprivileged user can display all terminals that do not 
recognize escape sequences but can only disable the option 
for device TI:. A privileged user can disable escape 
sequence recognition for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
with escape sequence recognition disabied. 
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Examples: 


>SET /NOESCSEQ=TT3: 


Disables escape sequence recognition for TT3:. 


>SET /NOESCSEQ 
NOESCSEQ=TTO: 
NOESCSEQ=TT1: 
NOESCSEQ=TT2: 
NOESCSEQ=TT3: 
NOESCSEQ=TT4: 


Displays all the terminals that cannot 
receive escape sequences. 


/FDX[=TTnn:] 


(Full-duplex terminal driver only.) Instructs’ the 


send or 


terminal 


driver to accept input from the specified terminal while 


simultaneously outputting to it. 


A nonprivileged user can display all the full-duplex 


terminals but can only enable the option for 


privileged user can enable the full-duplex option 
terminal. 


When you omit =TTnn:, the system displays 
full-duplex terminals. 


Examples: 


>SET /FDX=TT3: 


Tits. A 
for any 
all the 


Declares that TT3: is a full-duplex terminal. 


>SET /FDX 
FDX=TT1: 
FDX=TT3: 
Displays all the full-duplex terminais. 


/NOFDX[=TTnn: ] 


(Full-duplex terminal driver only.) Disables the full-duplex 
option; the terminal driver does not simultaneously process 


input and output from the specified terminal. 


A nonprivileged user can display all terminals that have the 
full-duplex option disabled but can only disable the option 
for TI:. A privileged user can disable the full-duplex 


option for any terminal. 


When you omit =TTnn:, the system displays all the 
that have the full-duplex option disabled. 
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Examples: 
>SET /NOFDX=TT3: 
Disables the full-duplex option for terminal TT3:. 


>SET /NOFDX 
NOFDX=TTO: 
NOFDX=TT2: 
NOFDX=TT3: 
NOFDX=TT4: 


Displays all the terminals that do not _ process 
input and output simultaneously. 


/FORMFEED[=TTnn: ] 


Indicates that the specified terminal has a hardware form 
feed. 


A nonprivileged user can display all terminals that have a 
hardware form feed but can only declare it for TI:. A 
privileged user can declare it for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have a hardware form feed. 


Examples: 


>SET /FORMFEED 
FORMFEED=TT1: 


Displays all the terminals that have a hardware 
form feed. 


>SET /FORMFEED=TT3: 
Declares that TT3: has a hardware form feed. 
/NOFORMFEED[=TTnn:] 


Indicates that the specified terminal will not have a 
hardware form feed. 


A nonprivileged user can display all terminals that do not 
have a hardware form feed but can only specify the option 
for TI:. A privileged user can specify the option for any 
terminal. 


When you omit =TTnn:, the system displays all the terminals 
that do not have a hardware form feed. 


Examples: 
>SET /NOFORMFEED 
NOFORMFEED=TTO: 
NOFORMFEED=TT2: 
NOFORMFEED=TT4: 
Displays all the terminals that do not have a 
hardware form feed. 
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>SET /NOFORMFEED=TT3: 


Specifies that TT3: will not have a hardware form 
feed. 


/HFILL=TTnn: [value] 

(Full-duplex terminal driver only.) Specifies the number of 
fill characters (value) that the terminal driver places 
after a carriage return when outputting to a terminal. The 
range for value is 0 through 7. 

A nonprivileged user can display the number of Fill 
characters for any terminal but can only change the value 
for TI:. A privileged user can specify the number of fill 
characters for any terminal. 


When you omit value, the system displays the fill character 
value for the specified terminal. 


Examples: 


>SET /HFILL=TT3: 
HFILL=TT3:0 


Displays the number of fill characters for TT3:. 
>SET /HFILL=TT3:3 


Specifies for TT3: that three fill characters 
follow a carriage return. 


/HHT[=TTnn: ] 
(Full-duplex terminal driver only.) Indicates to the 
terminal driver that the specified terminal has a hardware 
horizontal tab. 
A nonprivileged user can display all terminals that have a 
hardware horizontal tab but can only declare it for TI:. A 
privileged user can declare it for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have a hardware horizontal tab. 


Examples: 
>SET /HHT 
HHT=TT4: 
HHT=TT6: 
HHT=TT7: 


Displays all the terminals that have a hardware 
horizontal tab. 


>SET /HHT=TT3: 


Declares that TT3: has hardware horizontal tabs. 
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/NOHHT[(=TTnn: ] 


(Full-duplex terminal driver only.) Indicates that the 
specified terminal does not have a hardware horizontal tab. 


A nonprivileged user can display all terminals that do not 
have a hardware horizontal tab but can only declare it for 
TI:. A privileged user can declare it for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that do not have a hardware horizontal tab. 


Examples: 


>SET /NOHHT 
NOHHT=TTO: 
NOHHT=TT1: 
NOHHT=TT2: 


Displays all the terminals that do not have a 
hardware horizontal tab. 


>SET /NOHHT=TT3: 


Declares that tTT3: does not have ae hardware 
horizontal tab. 


/HOLD[=TTnn: ] 


Enables hold-screen mode at the specified CRT terminal. 
When hold-screen mode is enabled, the terminal displays 
output one screenful at a time. The screenful of output 
remains on the screen until you type the SCROLL key while 
pressing the SHIFT key. The terminal then refills the 
screen. You can also advance the screen contents one line 
at a time by typing the SCROLL key. 


Hold-screen mode is useful when copying files to terminals 
that normally transmit output at high baud rates (9600, for 
example). Note, however, that hold-screen mode may not be 
appropriate for use with certain types of programs (editors 
or terminals using different speeds for input and output, 
for example). 


A nonprivileged user can display all terminals currently in 
hold-screen mode but can only place TI: in hold-screen 
mode. A privileged user can place any terminal in 
hold-screen mode. 


When you omit =TTnn:, the system displays all the terminals 
currently in hold-screen mode. 


Examples: 
>SET /HOLD=TT3: 
Enables hold-Screen mode for CRT terminal TT3:. 


The terminal erases its screen and positions the 
cursor at the top left (home) of the screen. 


3=185 


MCR COMMANDS 
SET (Cont.) 


>SET /HOLD 
HOLD=TT3: 
HOLD=TT7: 
HOLD=TT12: 


Displays all the terminals that have hold-screen 
mode enabled. 


/NOHOLD[=TTnn:] 
Disables hold-screen mode at the specified CRT terminal. 
A nonprivileged user can display all terminals not in 
hold-screen mode but can only disable the option for TI:. A 
privileged user can disable hold-screen mode for any 


terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have hold-screen mode disabled. 


Examples: 
>SET /NOHOLD=TT3: 
Disables hold-screen mode for terminal TT3:. 
>SET /NOHOLD 
NOHOLD=TTO: 
NOHOLD=TT3: 


Displays all the terminals that have hold-screen 
mode disabled. 


/LIBUIC[=[uic]] 


s the UIC. for. the. 
es. This UIC usually. 
| and precede the task 
_ the system first 
£ the file cannot be 
default LIBUIC is. 


(RSX-11M=PLUS 
 nonprivileged 
-.. contains nonp 
you issue 
mame with é 
searches. fo 
-. found, the sy 
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/LINES=TTnn: [value] 


(Full-duplex terminal driver only.) Establishes the number 
of lines per page (value) for the terminal. The range for 
value is 1 through 255(10). To specify a decimal value, 
place a period (.) after the number. 


A nonprivileged user can display the number of lines per 
page for any terminal but can only specify the number for 
TI:. A privileged user can specify the number of lines per 
page for any terminal. 


When you omit value, the system displays the number of lines 
per page for the specified terminal. 


Examples: 


>SET /LINES=TT3: 
LINES=TT3:24. 


Displays the number of lines per page for TT3:. 
>SET /LINES=TT3:20 


Specifies in octal the number of lines per page 
for TT3% 3 


/ LOGON 


(Privileged keyword.) Enables logging in on terminals in a 
multiuser protection system. 


/NOLOGON 


(Privileged keyword.) Disables logging in on terminals in a 
multiuser protection system. 


/LOGON and /NOLOGON clear and set a flag checked by the 
HELLO command when a user attempts to log in on a terminal. 
/NOLOGON provides a means of preventing users from accessing 
the system during such activities as system maintenance or 
account file maintenance, 


/LOWER[=ddnn:] 


Specifies that lowercase characters on a terminal or line 
printer are not to be converted to uppercase when they are 
received from the device driver. Note that this keyword 
only affects input from a terminal, not output to a 
terminal. 


A nonprivileged user can display all devices that do not 
convert lowercase characters to uppercase but can only 
specify the option for TI:. A privileged user can _ specify 
the option for any terminal or line printer. 


When you omit =ddnn:, the system displays all the devices 


for which lowercase characters are not converted to 
uppercase. 
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Examples: 
>SET /LOWER=TT3: 


Inhibits conversion of lowercase characters to 
uppercase when they are received from TT3:. 


>SET /LOWER 
LOWER=LP0: 
LOWER=TT1: 
LOWER=TT3: 
LOWER=TT7: 


Displays all the devices for which lowercase 
characters are not converted to uppercase. 


/NOLOWER [=ddnn:]} 


Resets the characteristics for the terminal or line printer. 
For terminals, lowercase characters received on input are 
automatically converted to uppercase and echoed as 
uppercase. The keyword has no effect on characters output 
to the terminal. For line printers, lowercase characters 
output to the device are printed as uppercase. 


A nonprivileged user can display all the devices that 
perform this conversion but can only specify the option for 
TI:. A privileged user can specify the option for any 
terminal or line printer. 


When you omit =ddnn:, the system displays all the devices 
for which conversion to uppercase is specified. 


Examples: 
>SET /NOLOWER 
NOLOWER=LP1: 
NOLOWER=TTO: 
NOLOWER=TT2: — 
NOLOWER=TT4: 


Displays all the devices that automatically 
convert lowercase characters to uppercase. 


>SET /NOLOWER=TT3: 


Resets TT3: so that lowercase characters are 
automatically converted to uppercase. 


/MAIN=pname[:base:size:type] 
(On RSX-11M-PLUS systems, synonym for /PAR.) Establishes the 
specified partition as a main partition. A nonprivileged 
user can only display the base, size, and type of a main 
partition. 


pname 


The 1- to 6-character alphanumeric partition name. 
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sbase 


The physical base address of the partition, specified 
as a number of 64-byte blocks. 


:size 


The size of the partition, specified as a number of 
64-byte blocks. 


:type 


The partition type: 


SYS A system-controlled task partition 


COM A common partition 
DEV A common partition mapping into the device 
registers 


User-controlled and system-controlled task partitions 
contain user tasks. Common partitions are used for resident 
libraries and common blocks. Device partitions are used by 
nonprivileged tasks to access device registers in the 
external page, such as those for the UDC and ICS/ICR-1l. 


Base and size can be entered in any of the following formats 
(nnnn is a number’ in bytes to which the system applies a 
multiplication factor to determine the value used): 


Format Calculated Value 
nnnn Octal (nnnn*100) 

nnnn. Decimal (nnnn.*64.) 
nnnk Octal K (nnn*4000) 
nnn.K Decimal K (nnn.*2048.) 


Valid ranges of calculated values (in words) are: 


Octal 0<=base<177777 0<size<2000 
Decimal 0.<=base<65535 0.<size<1i024. 
Octal K OK<=base<3777K OK<size<40K 
Decimal K 0.K<=base<2047.K 0.K<size<32.K 


For system-controlled partitions, size may range from 0 to 
1920.K or any valid representation of these limits. 


For example, any of the following inputs for size will 
allocate a 2048(10)-byte partition. 


40 
32. 
1K 


? 
Lek 


3-189 


MCR COMMANDS 


SET (Cont.) 


If you omit base, size, and type, the system displays the 
values of these parameters for the named partition. If the 
named partition is a task partition, the system also 
displays the parameters of all its subpartitions. 


Examples: 
>SET /MAIN=SYSPAR: 420:140:TASK 


Defines a main partition named SYSPAR as a 
user-controlled partition whose base address is 
42000(8) and whose length is 14000(8) bytes. 


>SET /MAIN=SYSPAR 
MAIN=SYSPAR: 0420:0140: TASK 


Displays the parameters of the main partition 
SYSPAR. Note that if the main partition is a task 
partition and contains subpartitions, the 
parameters of the subpartition are also displayed. 


/NOMAIN=pname 


(On RSX-11M-PLUS systems, Synonym for /NOPAR; privileged 
keyword.) Eliminates the specified partition from. the 
system. 


Example: 
>SET /NOMAIN=SYSPAR 


Eliminates the main partition SYSPAR from the 
system. 


/MAXEXT[=size] 


(Privileged keyword.) Establishes the maximum size to which 
a task can extend itself beyond its mapped array area by 
means of the EXTEND TASK directive (see the RSX-11M/M-PLUS 
Task Builder Manual for information about arrays and the 
RSX-11M/M-PLUS Executive Reference Manual for a description 
of the directive). 


The keyword is only valid on mapped RSX-11M systems” that 
selected the EXTEND TASK directive option during system 
generation and on all RSX-11M-PLU systems. Note that a 
nonprivileged user can display the maximum size to which a 
task can extend itself (but not change the size). 


The maximum size can be expressed in four formats: 
n 
nk 
ris 
n.K 


See the description of the /MAIN or /PAR keyword for a 
definition of these size values. 
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When you omit =size, the system displays the current maximum 
size in the format: 


MAXEXT=m 
where m is an octal number equal to the maximum size in 


64-byte blocks allowed for a task (for example, 1200 
indicates 20K words). 


Examples: 
>SET /MAXEXT=20.K 


Establishes 20.K as the maximum size to which a 
task can extend itself. 


>SET /MAXEXT 
MAXEXT=12000 


Displays the current maximum size to which a_ task 
can extend itself. 


/MAXPKT [=n] 


Specifies the maximum number of I/O packets to be retained 
in a separate queue for use by the QIO directive. The 
number of retained packets (n) is used to optimize the 
servicing of QIO requests. The range for n is 0 through 
15(10). 


A nonprivileged user can only display the maximum and 
Current number of available I/O packets. 


When you omit =n, the system displays the maximum number and 
the current number of available I/O packets in the format: 


MAXPKT=m.:C. 


where m. is the maximum number of and c. is the current 
number of available I/O packets. 


Examples: 
>SET /MAXPKT=12. 


Sets the maximum number of I/O packets' retained 
for optimization of I/O servicing to 12(10). 


>SET /MAXPKT 
MAXPKT=12.:3. 


Displays the maximum and current number of 1/0 
packets. The maximum number of I/O packets to be 
retained explicitly for QIO processing is 12(10). 
Three packets are currently available. 
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/MCR[=TTnn:] 


Enables MCR command recognition at the specified terminal. 
Commands entered in response to the default prompt are 
submitted to MCR. 


A nonprivileged user can display all the terminals’ that 
recognize MCR commands but can only specify the option for 
TI:. A privileged user can enable MCR command recognition 
for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that recognize MCR commands. 


/MCR is valid only on systems that have multi-CLI support. 
Examples: 

>SET /MCR 

MCR=TT1: 

MCR=TT2: 

MCR=TT3: 


Displays all the terminals that recognize MCR 
commands. 


>SET /MCR=TT4: 


Enables MCR command recognition for TT4:. 


/NETUIC[=[uic] ] 


Specifies the UIC in which all DECnet-related tasks are 
stored. The keyword applies only to systems that selected 
the external communication products option during system 
generation. 


On RSX-11M, if you did not select support for DECnet at 
_system generation, NETUIC defaults to SYSUIC. 


A nonprivileged user can display the current network UIC, 
but only a privileged user can set or change it. 


When you omit =[uic], the system displays the current 
network UIC. 


Examples: 


>SET /NETUIC 
NETUIC=[20, 34] 


Displays the current network UIC. 
>SET /NETUIC=[110,3] 


Sets the network UIC to [110,3]. 
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/PLCTL[=[high] [: [low] [: [frsiz] [:basep]]]] 


(Privileged keyword.) Sets the pool limit parameters used by 
the Pool Monitor Task (PMT). The following list defines the 


parameters 
high 
low 


frsiz 


basep 


The high pool limit in bytes. 
The low pool limit in bytes. 


The minimum byte size of the largest free pool 
block required for avoiding low-pool action by 
the Pool Monitor Task. 


The base task priority, which is the lowest 
priority a nonprivileged task can have and 
still be eligible for memory contention during 
times of low pool; this priority remains in 
effect until pool conditions improve. Note 
that only those tasks requested while the 
system is in a low pool state are affected. 


The following list defines the limits of the parameters: 


84. 
84. 
0; 
The follow 
high 
low 
frsiz 
basep 


See the 


<= 


low <= high <= total size of system pool 


<= frsiz <= high 


<= basep <= 250. 


ing 


RSX- 


list gives the defaults for the parameters: 


1600. bytes 


600. bytes 
200. bytes 
Bilis 


11M/M-PLUS System Management Guide for 


information on determining the values for the parameters. 


When you 


omit 


the parameters, the system displays’ the 


current parameters for the system. 


Example: 


>SET /PLCTL 
PLCTL=1600.:600.:200.:51. 


Displays the current settings for the pool limit 
parameters. 
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/POOL[=top] 


Increases the size of the dynamic storage region (pool). 
The parameter top specifies the first location in memory to 
be used for user partitions. You specify the location in 
units of 64-byte blocks. The location can be given as an 
octal or decimal number. 


A nonprivileged user can only display the size of the 
dynamic storage region. 


When you omit =top, the system displays the size of the 
dynamic storage region in the format: 


POOL=top:max.:total. 
top 


The first location for user partitions (displayed in 
bytes with two trailing zeros suppressed). 


max. 

The longest free block (displayed in words). 
total. 

The total pool space (displayed in words). 
Examples: 

>SET /POOL=1200 


Establishes 120000(8) as the beginning location 
for user partitions. 


>SET /POOL 
POOL=1200: 03380. :06322. 


Displays the first location for user partitions, 
the longest free block, and the total of all pool 
Space (the first free block is at 120000, the 
longest free block is 3380 decimal words, and the 
total pool space is 6322 decimal words). 


PRIV({=TiInn:] 


Establishes the specified terminal as a privileged terminal. 
A nonprivileged user can only display the terminals that are 
privileged. A privileged user can set any terminal to be 
privileged. . 


When you omit =TTnn:, the system displays all the privileged 
terminals. 
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Examples: 
>SET /PRIV=TTL: 
Establishes TT1l: as a privileged terminal. 
>SET /PRIV 
PRIV=TTO: 
PRIV=TT1: 
Displays all the privileged terminals. 
/NOPRIV[=TTnn:] 
Establishes the specified terminal to be nonprivileged. 
A nonprivileged user can only display the terminals that are 
nonprivileged. A privileged user can set any terminal to be 


nonprivileged. 


When you omit =TTnn:, the system displays all the 
nonprivileged terminals. 


Examples: 
>SET /NOPRIV 
NOPRIV=TT2: 
NOPRIV=TT3: 
Displays all the nonprivileged terminais. 
>SET /NOPRIV=TT1: 
Establishes TTl: as a nonprivileged terminal. 
/PUB[=ddnn:] 
(RSX-11M multiuser protection systems and RSX-1L1M-PLUS 
systems only.) Establishes the specified device as a public 
device. A public device is one that can be accessed by all 
system users. Note that allocated and already mounted 
devices cannot be set public. (Devices can be set public 


before they are mounted.) 


A nonprivileged user can display all the public devices, but 
only a privileged user can establish a device as public. 


When you omit =ddnn:, the system displays all the public 
devices. 


Examples: 
>SET /PUB=LP: 


Establishes LPO: as a public device. 
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>SET /PUB 
PUB=DBO: 
PUB=DB1: 
PUB=LP0: 


Displays all the public devices. 
/NOPUB=[ddnn:] 
(RSX-1L1M multiuser protection systems and RSX-11M-PLUS 


systems only.) Establishes the specified device as a 
nonpublic device. A nonprivileged user can display the 


devices that were previously set public but are now 
nonpublic, but only a privileged user can make a _ public 
device nonpublic. Note that mounted devices cannot lose 


their public status. 


When you omit =ddnn:, the system displays all the devices 
actually in use that are not public devices. 


Examples: 


>SET /NOPUB 
NOPUB=DKO0: 
NOPUB=DK1: 


Displays all the private and unowned (nonpublic) 
devices. 


>SET /NOPUB=LP0: 
Establishes LPO: as a nonpublic device. 
/REMOTE [=TTnn: [speed] ] 


Declares that the specified terminal is connected to a modem 
and can be connected by means of a dial-up network. The 
terminal has a line to a DH1l1, DHV11, DL11, DLV11, DZ11l, or 
DZV11l multiplexer. 


A nonprivileged user can display all remote lines, but only 
a privileged user can declare a terminal as a remote line. 


Specifying speed establishes the initial baud rate (answer 
speed) of the remote dial-up line for the specified 
terminal. You may specify an answer speed only for DHlls, 
DHV1I1s, DZ1lls, and DZVlls, which are variable-speed 
multiplexers. (You cannot specify an answer speed for DL1ls 
or DLV1lls.) 


Valid speeds for the DH1l are 0, 50, 75, 110, 134.5, 150, 
200, 300, 600, 1200, 1800, 2400, 4800, 9600, EXTA 
(user-specified baud rate A), and EXTB (user-specified baud 
rate B). 


Valid speeds for the DHV1ll are 75, 110, 134.5, 150, 300, 
600, 1200, 1800, 2000, 2400, 4800, 9600, and 19200. 


3-200 April 1983 


MCR COMMANDS 


SET (Cont.) 


Valid speeds for the DZ1l and DZV11 are 50, 75, 110, 134.5, 
150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, and 
9600. 

When you omit =TTnn:, the system displays all the remote 
terminals. When you omit speed, the current setting for the | 
terminal remains in effect. 


Examples: 


>SET /REMOTE | 
REMOTE=TT1:1200 
REMOTE=TT2:0 
REMOTE=TT4 :0 


Displays all the terminals that are currently set 
as remote dial-in lines. 


>SET /REMOTE=TT3:1200 


Sets the terminal line corresponding to TT3: asa 
remote dial-in line. The initial baud rate 
(answer speed) for the line will be 1200. 


/NOREMOTE [=TTnn: ] 


Declares that the terminal's line is a local line not 
connected to a modem. e 


A nonprivileged user can display all local lines, but only a 
privileged user can declare a terminal as local. 


When you omit =TTnn:, the system displays all the local 
lines (including DL11, DLV11, DH11, DHV11, DZ11, and DZvll J 
multiplexers). 


Examples: 
>SET /NOREMOTE=TT3: 


Declares that the terminal line for MTT3: is a 
local line. 


>SET /NOREMOTE 
NOREMOTE=TTO: 
NOREMOTE=TT3: 


Displays all the local lines (including DbLll, 
DLV11, DH11, DHV11, DZ11, and DZV11 multiplexers). 


/RNDC [=nn] 


Defines the length of the Executive round-robin scheduling ® 
interval in ticks. The parameter nn can be an octal value, 

or decimal if followed by a period (.). The minimum value 
for nn is 0. See the RSX-11M or RSX-11M-PLUS System 
Generation and Installation Guide for more information. 
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A nonprivileged user can display the value for the interval, 
but only a privileged user can change the value. 


When you omit =nn, the system displays the current value for 
the interval. 


Examples: 


>SET /RNDC 
RNDC=6. 


Displays the current length of the round-robin 
scheduling interval. 


>SET /RNDC=1O. 
Sets the length of the interval to 10(10) ticks. 
/RNDH [=nn] 
Defines the highest priority (1 through 250 decimal) that 
will be considered for Executive round-robin scheduling. 
The class must be higher than the one specified with /RNDL. 
See the RSX-11M or RSX-11M-PLUS System Generation and 


Installation Guide for more information. 


A nonprivileged user can display the value for the priority, 
but only a privileged user can change the value. 


When you omit =nn, the system displays the current value for 
the priority. 


Examples: 


>SET /RNDH 
RNDH=150. 


Displays the current highest priority class that 
is considered for round-robin scheduling. 


>SET /RNDH=120. 
Sets the highest priority class to 120(10). 
/RNDL f=nn] 
Defines the lowest priority (1 through 250 decimal) that 
will be considered for Executive round-robin scheduling. 
The class must be lower than the one specified with /RNDH. 


See the RSX-11M or RSX-11M-PLUS System Generation and 
Installation Guide for more information. 


A nonprivileged user can display the value for the priority, 
but only a privileged user can change the value. 


When you omit =nn, the system displays the current value for 
the priority. 


3-202 April 1983 


MCR COMMANDS 


SET (Cont.) 


Examples: 


>SET /RNDL 
RNDL=1 


Displays the current lowest priority class that is 
considered for round-robin scheduling. 


>SET /RNDL=20. 
Sets the lowest priority class to 20(10). 
/RPA[=TTnn:]} 


(Full-duplex terminal driver only.) Enables the 
read-pass-all option of the terminal driver. The terminal 
driver passes all input characters (including special 
function characters such as CTRL/C) to the driver input 
buffer. 


A nonprivileged user can display all terminals that have the 
option enabled but can only enable the read-pass-all option 
for TI:. A privileged user can enable the read-pass-all 
option for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have the read-pass-all option enabled. 


Examples: 


>SET /RPA 
RPA=TTO: 
RPA=TT1: 


Displays all the terminals where input characters 
are passed directly to the input buffer for the 
full-duplex terminal driver. 


>SET /RPA=TT3: 
Enables the read-pass-all option for TT3:. 
/NORPA[=TTnn: ] 


(Full-duplex terminal driver only.) Disables the 
read-pass-all option. The terminal driver does not pass 
special function input characters (such as CTRL/C) from the 
terminal to the driver input buffer. 


A nonprivileged user can display all terminals that have the 
option disabled but can only disable the read-pass-all 
option: .for Tl. A privileged user can disable the 
read-pass-all option for any terminal. 


When you omit =TTnn:, the system displays all the terminals 


that do not pass special function characters to the terminal 
driver input buffer. 
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Examples: 
>SET /NORPA 


NORPA=TT2: 
NORPA=TT4: 


Displays all the terminals that have the 
read-pass-all option disabled. 


>SET /NORPA=TT3: 


Specifies that TT3: not pass special function 
input characters to the input buffer for the 
full-duplex terminal driver 


etggeneee y. pool in units of | 


of 32-word. 


condary pool. — 
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/SLAVE[=TTnn:} 


Establishes the specified terminal as one that can enter 
data only if it is solicited from a task by a READ QIOS. 
Thus, the specified terminal always rejects unsolicited 
input (other than CTRL/O, CTRL/Q, and CTRL/S). 


A nonprivileged user can display all slave terminals but can 
only establish TI: as a slave terminal. Privileged users 
can establish any terminal as a slave terminal. 

When you omit =TTnn:, the system displays all the terminals 
currently classified as slaved. 
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Examples: 
>SET /SLAVE=TT3: 


Establishes TT3: as a terminal that can only 
enter data solicited by a task. 


>SET /SLAVE 
SLAVE=TT3: 


Displays all the slaved terminals. 
/NOSLAVE[=TTnn:] 
Removes Slave status from a specified terminal. 


A nonprivileged user can only display the nonslaved 
terminals. A privileged user can set any slaved terminal to 
be nonslaved. 


When you omit =TTnn:, the system displays all the nonslaved 
terminals. 


Examples: 


>SET /NOSLAVE 
NOSLAVE=TT0: 
NOSLAVE=TT1: 
NOSLAVE=TT2: 
NOSLAVE=TT4: 


Displays all the nonslaved terminals. 
>SET /NOSLAVE=TT3: 
Sets TT3: to be nonslaved. 
/SPEED=TTnn: [recv:xmit] 


Establishes the receive and transmit baud rate for terminals 
attached to the system through a DH11, DHV11, DZ1l, or DZV11 
variable-speed multiplexer. The argument "recv" is the baud 
rate at which characters are input to the computer from the 
terminal and the argument "xmit" is the baud rate at which 
characters are output to the terminal from the computer. 
Both must be specified in setting the _ speed. If neither 
argument is specified, the current settings are displayed. 


A nonprivileged user can display the speed settings for any 
terminal, but can only set the speed for TI:. A privileged 
user can set the speed for any terminal. 


Valid baud rates for the DH11 are 0, 50, 75, i110, 134.5, 
150, 200, 300, 600, 1200, 1800, 2400, 4800, 9600, EXTA 
(user-specified baud rate A), and EXTB (uSer-specified baud 
rate B). 
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Valid baud rates for the DHV1l1 are 75, 110, 134.5, 150, 300, 
600, 1200, 1800, 2000, 2400, 4800, 9600, and 19200. 


Valid baud rates for the DZ11 and DZV11l are 50, 75, 110, 


134.5, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 
7200, and 9600. 


If you have a DZ11l or DZV11, the receive and transmit baud 
rates must be the same because these multiplexers do not 
support split speeds. 
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Examples: 


>SET /SPEED=TT3: 
SPEED=TT3:2400:2400 


Displays the current speed setting for TT3:. 


>SET /SPEED=TT3:9600:9600 


Sets the receive and transmit baud rates for TT3: 
to 9600. 


a / aabode 
subpartition being “defined _ becomes 


-. 0<size<2000 
0.<size<1024, 
— OK<size<40K 
AO. KX81 Z8<32,K 


3-207 


MCR COMMANDS 


SET (Cont.) 


kee example, 


oe s for size will 


‘displays the current 


MCRPAR in the main 
address for MCRPAR is. 
Boge) pubes s ee 


ubpartition. 
n SYSPAR. The bs 
and its Jeagthe 


-/NosuB=nnane ‘name : : 
-(Rsx-11M systems only; privileged’ prion. ye ‘pelimingtes” the. 
named Buber tition (epamey from the BOeCT Ete main partition 
(name) . : git : veel 


eae 


>SET ‘/NOSUB- -SYSPAR: MCRPAR 


Eliminates the’ subpartition MCRPAR from the: 
partition SYSPAR. : 
/SWPC [=nn] 
Defines the number of clock ticks for a single Executive 
swapping interval. The parameter nn is in the range 0 
through 45,568(10) and can be an octal value, or decimal if 
followed by a period (.). See the RSX-11M or RSX-11M-PLUS 


System Generation and Installation Guide for more 
information. 


A nonprivileged user can display the value for the interval, 
but only a privileged user can change the value. 


When you omit =nn, the system displays the current value for 
the interval, 


eC 


Examples: 


>SET /SWPC 
SWPC=30. 


Displays the current number of clock ticks for the 
swapping interval. 


>SET /SWPC=60. 


Sets the new swapping interval to 60(10). 
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/SWPR[=nn] 


Defines a priority range for Executive swapping. The 
parameter nn is in the range 0 through 127(10) and can be an 
octal value, or decimal if followed by a period (.). 


The value for /SWPR affects the installed priority of all 
tasks. Each task is initiated at its installed priority 
Plus the value for nn (priority + nn). While the task is 
executing, its priority is decremented until it becomes the 
installed priority minus the value for nn (priority - nn). 
When the priority reaches this lower limit, the task is 
Swapped out so that another task with a higher priority can 
execute. The priority for the new task changes in the same 
way. See the RSX-11M or RSX-11M-PLUS System Generation and 
Installation Guide for more information. =" 


A nonprivileged user can display the value for the priority, 
but only a privileged user can change the value. 


When you omit =nn, the system displays the current value for 
the priority range. 


Examples: 


>SET /SWPR 
SWPR=5. 


Displays the current value for _ the swapping 
priority range. 


>SET /SWPR=10. 
Sets the new priority range to 10(10). 
/SYSUIC[=[uic] ] 
Establishes the UIC for the system and all system tasks. On 
most unmapped systems, the system UIC is [1,50]; on most 
mapped systems, the system UIC is [1,54]. These UIC values 
are the initial defaults on virgin systems. The UIC also 
becomes the default UIC used by the LOAD command and_ the 


install-run-remove option of the RUN command. 


A nonprivileged user can display the system UIC, but only a 
privileged user can change it. 


When you omit =[uic], the system displays the current system 
UIC. 


Examples: 


>SET /SYSUIC 
SYSUIC=[1,54] 


Displays the current system UIC. 
Sets the system UIC to [3,54]. 
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(Full-duplex terminal driver only.) Establishes the terminal 
type (value) for the specified terminal. Supported standard 
terminal types are: 


ASR33 LA30S LA120 VT55 VT105 
ASR35 LA34 LA180S VT6l VT125 
KSR33 LA36 VTO5B VT100 VT131 
LA12 LA38 VT50 VT1O1 VT132 
LA30P LA100 VT52 VT102 


A nonprivileged user can display the terminal type for any 
terminal but can only establish the terminal type for TI:. 
A privileged user can establish the terminal type for any 
terminal. 


When you omit the value parameter, the system displays the 
terminal type for the specified terminal. 


MCR also accepts an alternate form of the command. You can 
specify the terminal type and equate it to the desired 
terminal. This automatically associates certain 
characteristics of the particular terminal type with the 
specified terminal. (See the RSX-l11M/M-PLUS I/O Drivers 
Reference Manual for a list of the implicit characteristics 
for each terminal type.) The command is in the format: 


SET /term-type=TTnn: 


where term-type is one of the standard terminal types. Note 
that the terminal types are mutually exclusive. 


The half-duplex terminal driver also accepts the /term-type 
form of the command. However, the only legal terminal types 
for the half-duplex driver are /ASR33, /LA30S, and /VTO5B. 
The command associates implicit characteristics of the 
terminal type with the specified terminal, but, unlike the 
full-duplex terminal driver, the types are not mutually 
exclusive. 


The following list describes the effects of the keywords for 
the half-duplex terminal driver: 


/ASR33 Converts lowercase letters to uppercase 
before they are output to the terminal. 
/LA30S Indicates that fill characters necessary for 


the LA30S terminal are used after a carriage 
return. The number of fill characters used 
depends on the current carriage position at 
the time the carriage return occurs. 


/VTO5B Sets a vertical fill of three nulis after a 


line feed on 60 Hz systems and of four nulls 
on 50 Hz systems. 
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Examples: 


>'SET /TERM=TT3: 
TERM=TT3:VT52 


Displays the terminal type for TT3:. 
>SET /TERM=TT1 :LA36 

Establishes TTl: as an LA36 terminal. 
>SET /LA36=TT1: 


Same effect as previous example; establishes TT1: 
as an LA36 terminal. 


You can also use an alternate command form to display all 
the terminals that are not of a specific type. The format 
is as follows: . 


SET /NOterm-type 


Note that you cannot negate a terminal type for a terminal. 
You can only display the terminals not of a specific type. 
Negating terminal type returns a syntax error since the 
terminal would be of indeterminate type. 


/TOP=pname:value 


Directs MCR to move the top boundary of the specified 
system-controlled partition up or down the amount indicated 
by the value parameter, or sets the partition size to that 
amount. The keyword modifies the top boundary of a 
partition even if the partition has tasks installed in it. 
If you modify the partition so that it may be too small to 
hold the tasks installed in it, MCR displays a warning 
message but modifies the partition anyway. 


pname 


The 1l- to 6-character alphanumeric name _ for the 
system-controlled partition. 


value 
The number of 64-byte blocks. 


The value parameter can be supplied in five formats: 
+value, -value, value, +* or *, and -*, 


Seen 
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+value 


Moves the top boundary up by the specified amount. 
Moving the top boundary up makes the partition 
larger. 


NOTE 


You can supply the value in the same units 
as the base and size parameters in the 
/MAIN or /7PAR keywords described 
previously. 


—-value 


Moves the top boundary down by the_ specified 
amount. Moving the top boundary down makes the 
partition smaller. 


value 


Establishes the total partition size equal to the 
specified value by moving the top boundary. 


+e Or % 


Moves the top boundary up as far as_ possible. 
This format causes the top boundary to move to the 
bottom boundary of the partition above it or _ to 
the top of memory if the partition is the top 
partition in memory. 


Moves the top boundary down as far as_ possible. 
This format causes the top boundary to move down 
to the top of the first fixed task, common, or 
driver in the partition at the time the /TOP 
keyword is executed. If nothing is loaded into 
the partition, the partition assumes a size of one 
64-byte block. 


Examples: 


>SET /TOP=TSTPAR:+5 


Moves the top boundary of TSTPAR up by five 
64-byte blocks. 


>SET /TOP=PAR23:~-* 


Moves the top boundary of PAR23 down as far as 
possible. 
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/TYPEAHEAD[=TTnn (Gap 


(Full-duplex terminal driver only.) Instructs the terminal 
driver to store input characters in a buffer before passing 
the characters to a requesting task. Thus, characters input 
between requests are not lost. 


A nonprivileged user can display all terminals that have the 
typeahead option enabled but can only enable the option for 
Tiss A privileged user can enable typeahead for any 
terminal. These rules also apply to the size of the 
typeahead buffer. 


When you omit =TTnn:, the system displays all the terminals 
that have typeahead enabled. 


Examples: 


>SET /TYPEAHEAD 
TYPEAHEAD=TT1: 
TYPEAHEAD=TT2: 
TYPEAHEAD=TT7: 
TYPEAHEAD=TT12: 


Displays all the terminals for which the terminal 
driver stores input characters in a buffer before 
passing them to a task. 


>SET /TYPEAHEAD=TT3: 
Enables the typeahead option for TT3:. 
/NOTYPEAHEAD[=TTnn: ] 


(Full-duplex terminal driver only.) Disables the typeahead 
option; the terminal driver does not store input characters 
in a buffer to prevent their loss. 


A nonprivileged user can display all terminals that have the 
typeahead option disabled but can only disable the option 
for TI:. A privileged user can disable typeahead for any 
terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have typeahead disabled. 
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Examples: 


>SET /NOTYPEAHEAD 
NOTYPEAHEAD=TTO: 
NOTYPEAHEAD=TT4: 


Displays all the terminals that have typeahead 
disabled. 


>SET /NOTYPEAHEAD=TT3: 
Disables the typeahead option for TT3:. 
/UIC[=[uic] [:TTnn:] ] 


Establishes the specified UIC as the default UIC for the 
terminal. Unless TTnn: is specified, the default UIC is 
set for TI:. If the system supports multiuser protection 
(some RSX-11M and all RSX-11M-PLUS systems) and you are a 
privileged user, the command also sets the terminal's 
protection UIC (see Section 2.2.1). 


In a single-user system, all tasks run from the terminal are 
run with the UIC of the terminal. In a multiuser protection 
system, a privileged user can override the terminal UIC with 
the /UIC keyword for the RUN command. External MCR function 
tasks are also requested with the terminal's UIC. These 
tasks are the MCR MOUNT, INSTALL, DISMOUNT, and UFD commands 
(which run as tasks) and all system-supplied software. 


A nonprivileged user can only display and change the default 
UIC for TI:. A privileged user can display and change the 
default UIC for any terminal. 

When you omit =[uic], the system displays the current 
default UIC for TI:. When you omit =[uic] but specify 
=TTnn:, the system displays the current default UIC for that 
terminal. 

Examples: 


>SET /UIC 
UIC=[10,10] 


Displays the current default UIC for terminal TI:. 
>SET /UIC=[303,3] 
Sets the default UIC for terminal TI: to [303,3]. 


>SET /UIC=TT12: 
UIC=[12,20] 


Displays the current default UIC for TT12:. 
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/VFILL[=TTnn:] 


(Full-duplex terminal driver only.) Enables the vertical 
fill characters option for the specified terminal. The 
option instructs the terminal driver to add four fill 
characters following each line feed. 


A nonprivileged user can display all terminals that have the 
vertical f1i111 characters option enabled but can only enable 
it for TI:. A privileged user can enable the option for any 
terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have the vertical fill characters option enabled. 


Examples: 
>SET /VFILL 


VFILL=TTO: 
VFILL=TT1: 


Displays all the terminals that have the vertical 
fill characters option enabled. 


>SET /VFILL=TT3: 
Instructs the full-duplex terminal driver to add 
four fill characters following each line feed at 
TT3 2s 
/NOVFILL[=TTnn:] 


(Full-duplex terminal driver only.) Disables the vertical 
fill characters option for the specified terminal. 


A nonprivileged user can display all terminals that have the 
vertical fill characters option disabled but can only 
disable it for TI:. A privileged user can disable the 
option for any terminal. 
When you omit =TTnn:, the system displays all the terminals 
that have the vertical fill characters vertical fill 
characters option disabled. 
Examples: 

>SET /NOVFILL 

NOVFILL=TT2: 

NOVFILL=TT4: 


Displays all the terminals that have the vertical 
fill characters option disabled. 


>SET /NOVFILL=TT3: 


Disables the option for TT3:. 
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/WCHK [=ddnn:] 


Specifies that all write operations are to be followed by a 
write check for all Files-11 disk devices except DX: and 
DY:. The checks assure the reliability of data transfers to 
the specified disk. However, writing is slowed because 
there are two I/O operations instead of just one. 


On RSX-11M, Executive support for write checking is a system 
generation option and must be Selected for this command to 
have any effect. On RSX-11M-PLUS, support for write 
checking is always included. 


A nonprivileged user can only display the devices that have 
write checking enabled. A privileged user can enable write 
checking for any device that supports it. 


When you omit =ddnn:, the system displays all the Files-1l 
disk devices that have write checking enabled. 


Examples: 
>SET /WCHK 
WCHK=DBO0: 
WCHK=DKO0: 


Displays all the Files-11 disk devices that have 
write checking enabled. 


>SET /WCHK=DK1: 
Enables write checking for DKl:. 
/NOWCHK [=ddnn: ] 


Specifies that-write checking is to be disabled for the 
specified device. 


A nonprivileged user can only display the devices that have 
write checking disabled. A privileged user can disable 
write checking for any device. 

When you omit =ddnn:, the system displays all the Files-11l 
disk devices except DX: and DY: that have write checking 
disabled. 

Examples: 


>SET /NOWCHK 
NOWCHK=DB1: 


Displays all the devices that support write 
checking but have it disabled. 


>SET /NOWCHK=DK1: 


Disables write checking for DKl:. 
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/WRAP[=TTnn:] 


(Full-duplex terminal driver only.) Enables the wrap-around 
option. The wrap-around option instructs the terminal 
driver to generate a carriage return/line feed sequence when 
the number of input characters exceeds the terminal's buffer 
size. The carriage return/line feed sequence is transparent 
and does not appear in the input buffer. 


A nonprivileged user can display all terminals that have the 
wrap-around option enabled but can only enable it for TI:. 
A privileged user can enable wrap-around for any terminal. 


When you omit =TTnn:, the system displays alii the terminalis 
that have the wrap-around option enabled. 


Examples: 

>SET /WRAP 

WRAP=TT1: 

WRAP=TT2: 
Displays all the terminals for which a_ carriage 
return/line feed sequence is generated following 
an input string that exceeds the terminal's buffer 
size. 

>SET /WRAP=TT3: 


Enables the wrap-around option for TT3:. 


/NOWRAP [=TTnn: ] 


Disables the wrap-around option; the terminal driver does 
not accept input characters beyond the buffer size for the 
terminal. 

A nonprivileged user can display all terminals that have the 
wrap-around option disabled but can only disable it for TI:. 
A privileged user can disable the option for any terminal. 


When you omit =TTnn:, the system displays all the terminals 
that have the option disabled. 


Examples: 
>SET /NOWRAP 
NOWRAP=TTO: 
NOWRAP=TT4: 


Displays all the terminals that have the 
wrap-around option disabled. 


>SET /NOWRAP=TT3: 


Disables the wrap-around option for TT3:. 
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Notes on Memory Allocation Keywords (see Table 3-3): 


e If a partition contains an installed task common or loaded 
driver and a keyword (for example, /NOMAIN or /NOSUB) attempts 
to eliminate the partition, the system eee the command. 


e When defining a main partition or a sSubpartition, the name 
must not already be defined as a partition. In addition, a 
main partition cannot overlap any other main partition, nor 
can a subpartition of a main partition overlap any other 
subpartition of the main partition. An exception is for DEV 
partitions, which can overlap. Subpartitions cannot be 
created on the I/O page. 


e@ On RSX-11M systems, all partitions except the resident loader 
_- partition, LDRPAR, are considered to be user partitions. by ‘the 
/POOL keyword. Thus, seas premier. SYSPAR is pgensigered: to. be 
a user partition. = ==. 9...) os ee 


e Once you allocate space to the dynamic storage region (pool), 
the space can never be recovered for use in partitions. 


e System-controlled partitions cannot include Subpartitions 
explicitly defined by the SET command. An attempt to define 
subpartitions in system-controlled partitions in this way will 
be rejected. The Executive dynamically defines subpartitions 
in a system-controlled partition as they are needed for tasks 
installed in the partition. 


Command Error Messages: 
SET -- ALIGNMENT ERROR 


An attempt was made to create a partition, but the base 
address or size conflicted with existing partitions or 
physicai memory size. 


SET -- CANNOT. REMOVE EXECUTIVE COMMON 


The executive commons (on systems that support executive 
partitions) cannot be removed from the running system. The 
executive commons must be installed and removed with VMR 
(see the RSX-11M/M-PLUS System Management Guide). 


SET -- CLI IS RESTRICTED 
An attempt was made to set a terminal to a CLI, but the CLI 


was initialized with the /RESTRICT subkeyword. This means 
that only the CLI itself can set a terminal to the CLI. 
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-- CLI REQUIRES THE TERMINAL TO BE LOGGED IN 
An attempt was made to set a terminal to a CLI, but the 
terminal is not logged in. The CLI will only accept 
commands from logged-in terminals. 


-- DEVICE BUSY 


An attempt was made to set a terminal characteristic for a 
terminal that is busy (attached). 


-- DEVICE NOT TERMINAL 


An attempt was made to set terminal characteristics for a 
device that is not a terminal. 


-- DEVICE NOT VARIABLE SPEED MULTIPLEXER 

An attempt was made to set the baud rate for a terminal that 
was not attached to a DH11, DHV1l1, DZll, or oD2vil 
multiplexer. 


-~- FEATURE NOT SUPPORTED 


The command keyword specified a feature or device that is 
currently not incorporated into the system. 


-- INVALID SPEED 

The multiplexer line does not support the requested speed, 
or the command specified unequal receive and transmit baud 
rates for a DZ11 or D2ZV11. The DZ1l and DZV1l do not 
support split speeds. 


-- LINE NOT DZ11 


The command attempted to set to remote a line that was not 
attached to a DZ11 multiplexer. 


-- NON EXISTENT MEMORY 


An attempt was made to define a partition in nonexistent 
memory. 


-~- PARTITION ALREADY EXISTS 


An attempt was made to define a partition with a name 
already in use. 


-- PARTITION NOT SYSTEM-CONTROLLED 


An attempt was mad ton boundary of a 


e to mo et 
with the /TOP keyword. This can be done o 
system-controlled partitions. 
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SET -- SPACE USED 


An attempt was made to create a partition or subpartition in 
a storage area already occupied. 


SET -- TASK INSTALLED IN PARTITION 


An attempt was made to eliminate a partition or subpartition 
that contains installed tasks. 


(to define 
es = USER PARTIT 


‘tempted to create a 
controlled partitions: 
systems. that. do -not 
ace, a system generat lor 


~ (psx- 1M syst 
“partition gx 
greater than 3: 
‘support exte 
option. — 


‘SET -- VIRTUAL 7 


“(pee ineern 
terminal chi: 
be done. — 


SET -- WRITE CHECK NOT SUPPORTED 
An attempt was made to enable write checking on a device 


that does not support it. See the description of the /WCHK 
keyword for the valid devices. 
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SYSTEM SERVICE MESSAGE (P) 

The SSM command inserts text into the error log file. The text 
appears in error log reports produced by the error log report 
generator. 


For information on the report generator, see the RSX-11M/M-PLUS Error 
Logging Manual. 


Format: 
SSM message 
message 
Any text string up to a maximum of 79 characters. 
Example: 
>SSM TESTING VOLUME INTEGRITY ON DK1:, POSSIBLE FORMAT ERRORS. 


Inserts the message into the error log file. 
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TAL 


TASKLIST — ATL FORMAT (NP) 
The TAL command displays the names and status of all tasks or of a 
specific task installed in the system. The display format is the same 
as that of the ACTIVE TASK LIST (ATL) command. See the ATL command 
for a description of the printout. 
Format: 

TAL [taskname] 
taskname 

The name of a specific task. 


Examples: 


RSX-11M systems 


>TAL 
LDR... 112050 LDRPAR 112404 00253100-00255600 PRI - 248. DPRI —- 248. 
STATUS: -CHK FXD STP -PMD PRV NSD 


TI - coo: I10C - 0. BIO - 0. EFLG - 000001 000000 PS - 170000 

PC - 120354 REGS 0-6 120212 010364 177777 107646 074714 107614 120166 
RMDEMO 053550 GEN 046020 01036700-01065600 PRI - 225. DPRI = 225. 

STATUS: -CHK WFR -PMD PRV MCR 

TI - TTO: I10C - 0. BIO - 0. EFLG - 000021 040000 PS - 170010 

PC ~ 125234 REGS 0-6 000000 136257 132066 000000 136321 134560 121166 
FI1ACP 111550 GEN 067150 01164600-01230600 PRI - 149. DPRI —- 149. 

STATUS: STP ACP -PMD PRV NSD CAL 

TI - coO: I0C - 0. BIO - 0. EFLG - 000002 000001 PS - 170000 

PC - 135244 REGS 0-6 000010 000066 000016 000000 067420 111550 120244 
MCR... 110160 SYSPAR 114514 00202600-00212600 PRI - 160. DPRI - 160. 

STATUS: STP -PMD PRV MCR CLI NSD CAL 

TI - TT51: I0C - 0. BIO - 0. EFLG - 000001 040000 PS - 170000 

PC - 122436 REGS 0-6 000000 120476 122032 120432 010554 043552 120366 


RSX-11M-PLUS systems 


>TAL 
e«eRMD 006246+ GEN 114020 00741000-00770200 PRI - 225. DPRI - 225. 
STATUS: -EXE -CHK ~PMD PRV PRO XHR 


TI - NONE I0C - 0. BIO —- 0. EFLG - 001400 000000 
--e-DMO 006224+ GEN 114020 00741000-00756500 PRI ~ 160. DPRI - 160. 
STATUS: -EXE -PMD PRV PRO 


TI - NONE I0C - 0. BIO - 0. EFLG - 001326 000000 


oe a 
“secondary pool. 
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TASKLIST (NP) 


The TASKLIST command displays a description of each installed task. 
The display contains: 


1. Task name 

2. Task version identification 

3. Partition name 

4, Task priority 

5. Size of task in bytes (octal) 

6. Load device identification 

7. Disk address logical block number (octal) 


8. Task memory state 


Format: 


TAS[KLIST] [taskname] [/DEV=ddnn:] 
taskname 

The name of a specific task. 
/DEV=ddnn: 


Displays the names and status of all tasks installed from the 
specified device. 


If you specify both taskname and /DEV, the system displays 
information about the task installed from that device. 


Examples: 


>TAS 

LDR... 07.05 LDRPAR 248. 00002200 LBO:-01035303 FIXED 
TKTN 0353 SYSPAR 248. 00010000 LBO:-01126742 
RMDEMO X03.03 GEN 225. 00013700 SY0:-00352100 
MTAACP 0006 GEN 200. 00013000 DS0:-00000777 
F11IMSG vV0010 GEN 200. 00005400 SY0:-01053030 
MCR... 3.2 SYSPAR 160. 00010000 LBO:-01051626 
TAST17 O1 GEN 160. 00025000 LBO:-01051676 
---STO 000005 SYSPAR 151. 00010000 SY0:-01136540 
- -BYE 01.5 GEN 150. 00040000 LBO:-01051337 
FLIACP M0235 FCPPAR 149. 00040000 LBO:-01052445 
SECFCP M0235 GEN 149. 00026200 SY0:-00055463 
DTAACP M0235 GEN 149. 00026200 SY0:-01052554 
«+ eDMO 03.2 GEN 140. 00040000 LBO:-01051403 
ose tNl- O03 51 GEN 140. 00040000 LBO:-01051561 
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--eMOU 03.01 GEN 140. 00040000 LBO:-01051653 
-.-UFD V0407 GEN 140. 00040000 LBO:-010 


(User typed CTRL/O to suppress further output.) 


>TAS /DEV=DRO0: 

DROOF1 M0323 SYSPAR 149. 00055700 LBO:-00475656 FIXED 
F11ACP M0323 GEN 149. 00044000 LBO:-00315566 
DBO1F1 M0323 GEN 149. 00044000 LBO:-00315566 
DBO7F1 M0323 SYSPAR 149. 00044000 LBO:-00315566 FIXED 
ERRLOG V1.01 GEN 148. 00042200 LBO:-00335276 
PMD... 04.0 GEN 140. 00015200 LBO:-00503535 


HRC... 02 GEN 140. 00055100 LBO:-00505331 
SYSLOG 1.02 GEN 130. 00016300 LBO0:-00504250 
-.-INS 06 GEN 100. 00035400 LBO:-00502750 


The displays contain from left to right: task name, task version 
identification, partition name, task priority, task size, load 
device identification, logical block number on the load device, 
and task memory state. On a processor with less than 124K words 
of memory, the size field (fifth column) contains 6-digit rather 
than 8-digit numbers. 


FIXED indicates that the task is fixed in memory. 


CHECKPOINTED indicates that the task has been swapped out of 
memory to make room for a higher priority task. 


If the task version identification is missing (the rest of the 
line is offset to the left) or garbage, the task was installed 
from a disk that has since been removed from the drive or 
replaced by another one. 

Command Error Message: 


TAS -- TASK NOT IN SYSTEM 


The task specified in the command line is not currently 
installed in the system. 
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TIME (NP,P) 
The TIME command allows you to: 

e Set the current time of day (privileged) 

e Set the current date (privileged) 

e Display the current time and date 
Format: 

TIM[E] [hrs:mins[:secs]] [ml/day/year] 

or 


TIM[E] [hrs:mins[:secs] ] [day-m2-year] 


hrs 
Hours in the range 0 through 23. 
mins 
Minutes in the range 0 through 59. 
secs 
Seconds in the range 0 through 59 (optional parameter). 
mi 
Numeric representation of the month in the range 1 through 12. 
m2 
Three-letter abbreviation for the month. 
day 
Day in the range 1 through 31. 
year 
Year in the range 0 through 99. The year is relative to 1900, 
thus 1981 is entered as 81. 
Notes: 


@e When the command specifies neither time nor date, the system 
displays the current time and date on the entering terminal. 


e If a privileged user specifies the time and date, the command 
sets the clock and calendar. If only the time is specified, 
only the clock is set; if only the date is specified, only 
the calendar is set. 
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e A privileged user can specify the time and date in either 
order. 


e The form used to specify the date does not affect the display 
format. The date is always displayed as day-month-year. 


e All numeric values are decimal. No terminating period is 
necessary (or permitted). 


Examples: 


>TIM 
10:23:31 26-MAR-Si 


Displays the current time and date. 


>TIM 11:37 4/19/81 


Sets the time to 11:37:00 and the date to 19-Apr-81. 
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USER FILE DIRECTORY (NP,P) 

The UFD command creates a User File Directory (UFD) on a #Files-1l 
volume and enters its name into the Master File Directory (MFD). (See 
Section 2.1.1 for further information about UFDs.) 


Before creating a UFD, you must first initialize and mount (INI and 
MOU) the volume. 


On multiuser protection systems, a nonprivileged user can create a UFD 
only on a volume mounted on a privately allocated device. A 
privileged user can create a UFD on any mounted volume. 
Format: 

UFD ddnn: [volume-label] {[g,m] [/keyword(s) ] 
ddnn: 


Device unit containing the volume on which the UFD being created 
will reside. 


Default: none; must be specified. 
volume-label 


If specified, the label is compared with the label on the volume. 
Tf the names match, a UFD can be created. If they do not match, 
the command is rejected. 


Default: null; no check is made. 

[g,m] 
The UIC for the UFD. The UIC establishes the owner of the UFD. 
The variables g and m represent the group and member numbers, 
respectively, and can be in the range 1 through 377(8). The 
square brackets are required syntax. 
Default: none; must be specified. 

/ALLOC=number 
The number of directory entries for which space in the UFD is’ to 


be allocated. The specified number is rounded up to the next 
multiple of 32(10) 


Default: 32(10) 
/PRO=[system,owner ,group,world] 


Establishes access rights for the directory file. Access codes 
consist of four 4-code groups in the access rights word, as 


follows: 
R - Read 
W - Write 
E - Extend 
D -—- Delete 
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In each instance, the absence of the code means that the user 
class is denied the access right. 


The 


Square brackets are required syntax. 


Defaults: [RWED,RWED, RWED,R] 


Example: 


>UFD DM1:[1,1] 


Creates a user file directory (UFD) for the UIC [1,1] on 
DM1:. The name and file number of the UFD file are entered 
into the MFD. The name of the UFD is 001001.DIR;1, and its 
owner is UIC [1,1]. 


Command Error Messages: 


UFD 


UFD 


UFD 


UFD 


UFD 


UFD 


UFD 


UFD 


UFD 


~- CAN'T READ MCR COMMAND BUFFER 


The UFD was initiated by a RUN command rather than as an MCR 
command. 


-- DIRECTORY ALREADY EXISTS 

The requested UFD already existed on the volume. 

-- FAILED TO CREATE DIRECTORY 

No space existed on the volume or an I/O error occurred. 
-- FAILED TO ENTER IN MFD 


There was no room in the MFD or on the volume, or an I/O 
error occurred on the volume. 


-- HOME BLOCK I/O ERROR 


An error was detected while the volume home block was’ being 


. read. 


-- NOT FILES-11 DEVICE 


The volume on which the UFD was to be created was not a 
Files-11 volume and therefore could not support UFDs. 


-- VOLUME NOT MOUNTED 
The volume on which a UFD is to be created must be mounted. 
-- WRITE ATTRIBUTES FAILURE 


An error was encountered while the attributes of either the 
MFD or the newly created UFD were being written. 


-- WRONG VOLUME 


The volume label and the label specified in the command line 
did not match. 


3-229 


MCR COMMANDS 


UNB 


UNBLOCK (NP,P) 


The UNBLOCK command continues the execution of a previously blocked 
active task or allows a previously blocked dormant task to execute if 
it is requested to do so. (See the description of the BLOCK command.) 


On systems with multiuser protection, a nonprivileged user can unblock 
any active task running from the issuing terminal. A privileged user 
can unblock any task. On systems without multiuser protection, any 
user can unblock any task. 
The system automatically unblocks an active task when it is aborted. 
Format: 

UNB[LOCK] [taskname] [/TERM=TTnnn:] 


taskname 


The name of the task. If you omit taskname, the command unblocks 
the task requested from the issuing terminal (task TTnn). 


Examples: 


>UNB TST 


Unblocks task TSTT36 and allows it to continue executing. 
(TT36: is the number of the terminal from which the task is 
running.) 
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UNFIX (P) 

The UNFIX command frees a fixed task from memory. This allows’ tasks 
that have been waiting for the partition in which the fixed task 
resides to compete for the partition. However, if a fixed task exits 
or aborts, it still occupies the physical memory in the partition. 
UNFIX is the complement of the FIX command. 

Format: 


UNF[IX] taskname 


taskname 


The name of the task. 


Examples: 
>UNFIX XKE 


Unfixes task XKE, freeing the partition in which it resides 
for task competition. 


Command Error Message: 
UNF -- TASK NOT FIXED 


An attempt was made to unfix a task that was not fixed. 


3-231 


MCR COMMANDS 


UNL 


UNLOAD (P) 
The UNLOAD command removes a loadable device driver from memory. If a 
device is mounted, attached, or has outstanding I/O, its driver cannot 
be unloaded. Also, the UNLOAD command cannot remove a data base from 
Memory, even if the data base was loaded by means of the LOAD command. 
To unload a device driver from memory, the driver's symbol table (STB) 
file must reside on the system device (LB:) under the system UIC. The 
SET /SYSUIC command displays and defines the system UIC, but usual 
values are [1,50] for unmapped systems and [1,54] for mapped systems. 
Format: 

UNL[OAD] dd: 
dd: 

A 2-character ASCII device name. 
Example: 


>UNL LP: 


Unloads the loadable device driver for device LP:. 


Command Error Messages: 


EVICE ddnn: HAS UNITS ATTACHED, BUSY, AND/OR 


e. Device ddnn; is the first 
mounted, and/or has outs 
Fig : Cannot be unloaded. 
UNL -- DEVICE dd: NOT IN SYSTEM 

No such device exists in the system. 
UNL -- DEVICE NOT MOUNTED 

The system device (LB:) was not mounted. 


UNL -- DRIVER BUILT WITH WRONG EXECUTIVE STB FILE 


The STB file for the driver is not compatible with the 
current Executive. 


UNL -- DRIVER CANNOT BE UNLOADED 
The UNLOAD command attempted to remove a permanently 
resident device driver (that is, a driver built as part of 
the Executive). 


UNL -- DRIVER NOT LOADED 


The device driver specified in the UNLOAD command line was 
not resident in memory. 
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UNL -- FILE filename HAS ILLEGAL STB FORMAT 
The driver's STB file contained illegal object code or data. 


UNL -- ILLEGAL VALUE FOR SYMBOL symname IN FILE filename 


The symbol symname is defined to an illegal value by the 
file ddDRV.STB. Since ddDRV.STB had to pass a previous 
inspection by the LOA command, there probably has been a 


s:7 


procedural error or ddDRV.STB has been corrupted. 


UNL -- SYMBOL symname IS DOUBLY DEFINED BY FILE filename 


The symbol symname is defined twice in the specified file. 
Duplicate systems are illegal. The driver remains loaded. 


UNL -- SYMBOL symname IS UNDEFINED BY FILE filename 


The symbol symname was found in the specified file, but the 
symbol is not defined. 
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UNSTOP (NP,P) 

The UNSTOP command continues execution of a task that has been stopped 
internally by the Executive. Examples of stopped tasks are tasks that 
have issued a STOPSS or RCSTS (RECEIVE DATA OR STOP) directive. 


A nonprivileged user can only unstop tasks being run from the issuing 
terminal. A privileged user can unstop any stopped task. 


Format: 
UNS[TOP] [taskname] [/TERM=TTnnn:] 


taskname 


The name of the task. If you omit taskname, the command unstops 
the task being run from the issuing terminal (task TTnn). 


Examples: 
RSX-11M and RSX-11M-PLUS systems: 
>UNS TST 
Clears the stop bit for task TSTT17 and allows it to 
continue executing. (TT17: is the number of the terminal 
from which the task is running.) 
RSX-11M-PLUS systems only: 
>UNS LAR/TERM=TT131: 
Clears the stop bit for task LARTD1L and allows it to 


continue executing. The task is being run from TT131: 
CTD2) cs 
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THE INDIRECT COMMAND PROCESSOR 


This chapter describes the Indirect Command Processor (Indirect) and 
indirect command files as well as the processor directives that 
control the execution of Indirect. 


Note that parameter defaults and ranges for the [Indirect directives 
are specified in the build file for the Indirect task. These values 


are instaliation-specific and can be changed. This facility also 
applies to initial command line and default UIC processing, which are 
discussed in Section 4.2. Ask your system manager for more 


information. 


4.1 INDIRECT COMMAND FILES 


There are two types of indirect command files: indirect task command 
files and indirect command line interpreter (CLI) command files. The 
following sections describe these files. 


4.1.1 Indirect Task Command Files 


An indirect task command file is a text file containing a list of 
task-specific command lines. Rather than retyping a commonly used 
sequence of commands, you can type the sequence once, store it in a 
file, and direct the task to read the file for its commands instead of 
prompting at the terminal. Tasks respond to commands contained in an 
indirect command file as if the commands were entered directly from 
the terminal. Most system-supplied tasks on RSX-11M/M-PLUS, such as 
MACRO-11 or the Task Builder, accept indirect task command files. 


To initiate indirect task command files, replace the command line’ for 
a task with a file specification, preceded by an at sign (@). The 
task requesting input then accesses the specified file and starts to 
read and respond to the commands contained within it. For example, to 
initiate a file of MACRO-11 commands from MCR, input the following: 


>MAC @INPT.CMD 


The MACRO-11 Assembler accesses the file and then executes the command 
lines contained within the file INPT.CMD. 


The default file type for indirect task command files is .CMD. Thus, 
the command line in the previous example could also be input as 
follows: 


>MAC @INPT ET) 
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Some tasks allow nested command files (one file invokes another). See 
the appropriate task documentation for the maximum nesting depth 
allowed. 


Note that indirect task command files can only contain valid 
task-specific command lines. The Indirect directives (described in 
Section 4.6) cannot be used in such command files. 


4.1.2 Indirect CLI Command Files 


An indirect CLI command file is a text file containing a list of 
CLI-specific command lines and special directives that allow you to 
control command file processing (See Section 4.3). The indirect 
command processor (Indirect, which runs under the task name AT.) reads 
the indirect CLI command file, interprets the directives, and passes 
the CLI commands to the CLI. 


To initiate an indirect CLI command file, enter the file 
specification, preceded by an at sign (@), whenever the CLI can accept 
input. For example: 


>@CLIIPT.CMD fey) 


The default file type for indirect CLI command files is also  .CMD. 
Thus, the command line in the previous example could also be input as 
follows: 
>@CLIIPT fen 

Indirect CLI command files can also be nested. The maximum level of 
nesting depends on the version of the Indirect task you are using. 
Ask your system manager about the version or look at the build file 
for the Indirect task. 

Note that the Indirect directives described in this chapter can only 


be used in indirect CLI command files. All further references to 
indirect command files refer to CLI command files. 


4.2 INDIRECT COMMAND PROCESSOR 

When processing an indirect command file, the Indirect task (AT.) 
first reads the command file and interprets each command line either 
aS a command to be passed directly to the CLI or as ae request for 
action by Indirect. The directives to Indirect are distinguished by a 
period (.) as the first character in the line. 

The Indirect directives form a procedural language that allows you to: 


1. Define and assign values to logical, numeric, and_ string 
symbols 


2. Substitute a symbol's value into any line of the command file 
3. Perform arithmetic 

4, Manipulate strings 

5. Display text on the user's terminal 


6. Ask questions of a user 
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7. Control the flow of a command file 
8. Call subroutines 
9. Detect error conditions 
10. Test symbols and conditions 
11. Create and access data files 
12. Parse commands and data 
13. Enable or disable any of several operating modes 
14. Control time-based and parallel task execution 


Two directives (.BEGIN and .END) permit you to block structure the 
command file and create Begin-End blocks. Modular, block-structured 
command files are easier to debug and maintain. More importantly, 
Begin-End blocks isolate local symbol definitions as well as labels 
and thus conserve symbol table space. 


When you define a symbol, Indirect creates an entry for the definition 
in an internal symbol table. These symbol table entries retain their 
definitions throughout the execution of the command file if defined 
locally or throughout the execution of all levels of nested command 
files if defined globally. Local ‘symbols defined within a_ block, 
however, retain their definitions only throughout the execution of the 
commands within that block; they are erased from the symbol table 
when Indirect encounters an .END directive. 


An Indirect directive (.ENABLE GLOBAL; Section 4.6.12) allows the 
definition of some symbols as global to all file levels. Otherwise, 
each time Indirect enters a deeper level (and if the /LO switch has 
not been specified; Section 4.5), it masks all symbols defined by the 
previous level out of the symbol table so that only symbols defined in 
the current level are available. These symbols are local only to the 
level of the file in which they are defined. When control returns’ to 
a previous level, the symbols defined in that level become available 
once again and the ones from the lower level are lost. 


When Indirect reaches the end of the highest level indirect command 
file, it displays the message (unless inhibited by the .DISABLE 
DISPLAY directive) 


>@ <EOF> 
and then exits. 


Indirect displays on the requesting terminal every CLI command line as 
it is executed. However, if Indirect is activated by @filename/-MC or 
by @filename/-CLI, CLI command lines in the Indirect file are 
converted to comments with a leading exclamation point (!); the CLI 
command lines are displayed but not executed. 


An Indirect file can also include comments, which the processor prints 
at the requesting terminal. Comments that begin a line interpreted by 
the CLI have a leading semicolon (;). (In some cases, the semicolon 
can be preceded on the same line by a directive to Indirect.) Comments 
that appear after the start of a CLI command line have a leading 
exclamation point (!). All lines in an indirect command file that 
begin with a period in column 1 followed by a semicolon (.;) are 
treated as comments but are not displayed when the file is processed. 
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Indirect attaches the terminal while processing contiguous comment 
lines that begin with a semicolon. This permits you to type CTRL/O 
and suppress a lengthy comment. Output is resumed by typing another 
CTRL/O or is resumed at the next CLI command line or Indirect 
directive statement in the command file. 


Note that no command or comment lines are displayed if .ENABLE QUIET 
is in effect. 


References to task names in an indirect command file follow the rules 
used for MCR and DCL. If the task was started as an external CLI task 
(for example, MAC, PIP, DMO), it may be referenced by its 3-~character 
name (xxx). Thus, such directives as .IFINS, .IFACT, and .WAIT need 
only specify the 3-character task name; Indirect can then find the 
correct task. However, you can always refer to a specific task by 
using its full 6-character name (...xxx or xxxtnn). 


If you do not specify a file name in the initial command line, 
Indirect can construct the name of a default file to be opened. The 
default file is named INDINIxxx.CMD, where xxx is null or _ the 
three-character task name that was used to initiate Indirect. Note, 
however, that this facility is currently disabled. To enable it, the 
value in the build file for the Indirect task must be changed. 


If a specified command file cannot be found in the current UIC, 
Indirect can also search for the file in another UIC. However, to 
enable this facility, the value in the build file for the Indirect 
task must be changed to be nonzero. If the new value is 1, Indirect 
searches for the file in LB:[sysuic] on RSX-11M systems and in 
LB: [libuic] on RSX-1L1M-PLUS systems. If the new value is greater than 
377(8), Indirect considers it to be the octal equivalent of the UIC 
(on LB:) to be searched. 


4.3 SUMMARY OF INDIRECT DIRECTIVES 

The Indirect directives described in this chapter are listed here by 
category. A detailed description of each directive is presented in 
alphabetical order in Section 4.6. 


Label Definition 


-label: Assigns a name to a line in the command file 
so that the line may be referenced. 


Symbol Definition 


-ASK Defines or redefines a logical symbol and 
assigns the symbol a true or false value. 


. ASKN Defines or redefines a numeric symbol. and 
assigns the symbol a numeric value. 


- ASKS Defines or redefines a string symbol and 
assigns the symbol a character string value. 


.» ERASE Deletes ail local or globai symbol 
definitions or a single global symbol 
definition. 


-SETT/.SETE Defines or redefines a logical symbol and 
assigns the symbol a true or false value. 
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- SETN Defines or redefines a numeric symbol and 
assigns the symbol a numeric value. 
-SETD/.SETO Redefines the radix of a numeric symbol. 


sSErL Defines or redefines a logical symbol and 
assigns the symbol a true or false value. 


soBTS Defines or redefines a string symbol and 
assigns the symbol a character string value. 


File Access 


~ DATA Specifies a single line of data to output to 
a file. 
. CHAIN Closes the current indirect file and uses 


commands from another file. 


- CLOSE Closes a file. 

- OPEN Creates and opens an output data file (if the 
file exists, creates a new version and opens 
Le) < 

-OPENA Opens an existing file and appends subsequent 
data (does not create a new version). 


Defaults to .OPEN if the file does not exist. 


- OPENR Opens a file for reading with the .READ 
directive. 

. PARSE Parses Strings into substrings. 

. READ Reads a record from a file into a _ specified 


string variable. 


Logical Control 


.» BEGIN Marks the beginning of a Begin-End block. 
. END Marks the end of a Begin-End block. 
~ EXIT Terminates processing of either Indirect or 


the current command file, returns control to 
the invoking terminal or to the previous 
level, and optionally sets special symbol 
<EXSTAT> value. 


-GOSUB Calls a subroutine within the command file. 

-GOTO Branches to a label within the command file. 

/ Defines logical end-of-file. Terminates file 
processing and exits. This directive is 


equivalent to the .STOP directive. 


- ONERR Branches to a label upon detecting a specific 
AT. error condition. 


- RETURN Effects an exit from a subroutine and returns 
to the line immediately following the 
Subroutine call. 


- STOP 


Logical Tests 


LF 


. IFACT/.IFNACT 


.IFDF/.IFNDF 

. IFENABLED/ 

. IFDISABLED 

. IFINS/.IFNINS 
. IFLOA/.IFNLOA 
.IFT/.IFF 
.TEST 


.- TESTDEVICE 


~ TESTFILE 


.- TESTPARTITION 
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Terminates indirect command file processing 
and optionally sets Indirect exit status. 
This directive is equivalent to the logical 
end-of-file (/) directive. 


Determines whether or not a symbol satisfies 
a condition. 


Determines whether or not a task is active. 


Determines whether or not a symbol is 
defined. 


Tests the .ENABLE/.DISABLE options. 


Determines whether or not a task is installed 
in the system. 


Determines whether or not a device driver is 
loaded. 


Determines whether a logical symbol is true 
or false. 


Tests the length of a string symbol or 
locates a substring. 


Returns information about a device in the 
system. 


Determines if a specified file exists and 
determines the physical device associated 
with a logical device name (performs device 
translation). 


Returns information about a partition in the 
system. 


Enable or Disable an Operating Mode 


.- ENABLE/.DISABLE 


Enables or disables control of the following 
modes: 


substitution 

timeout parameter 

lowercase 

terminal attachment 

data 

global symbol 

symbol radix 

command line echo 

command display 

field display 

command pasSing to default CLI 
file deletion 

truncate error suppression 
escape 

escape-sequence recognition 
control-Z exit 

overflow 
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Increment or Decrement Numeric Symbols 


«DEC Decrements the value of a numeric symbol by 
one. 
- INC Increments the value of a numeric symbol by 
one. 
Execution Control 
. DELAY Delays the execution of an indirect command 


file for a specified period of time. 


- PAUSE Suspends the indirect command file processor 
and allows user action. 


~WAIT Waits for a specified task to complete 
execution and sets the special symbol 
<EXSTAT> with the completed task's exit 
status. 

sxOT Initiates a task, passes a command line to 
it, and continues indirect command file 


processing without waiting for the task to 
complete. 


Special Purpose 


4.4 SYMBOLS 


The indirect command processor enables you to define symbols. These 
symbols can then be tested or compared to control flow through the 
indirect command file. They may also be substituted in CLI commands, 
data records for data files, or comments’ to be displayed on the 
terminal. 


Symbol names are ASCII strings from one through six characters in 
length. They must start with a letter (A through Z) or a dollar sign 
(S$). The remaining characters must be alphanumeric or a dollar sign. 
There are three symbol types: 

e Logical 

e Numeric 

e String 
A logical symbol has either a true or false value. 
A numeric symbol can have a numeric value in the range of 0 through 
65535(10). The symbol can be defined to have either a decimal or 
octal radix. The radix is relevant only when the symbol is 


substituted (see Section 4.4.2). 


A string symbol has as its value a string of ASCII characters, with a 
length of 0 through 132(10) characters. 
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A symbol's type (logical, numeric, or string) is defined by the first 
assignment directive that assigns a value to the symbol. Assignment 
directives can assign: 


e A true or false value to define a logical symbol 
(Defined by .ASK, .SETL, .SETT, or .SETF.) 


e An octal or decimal number to define a numeric symbol 
(Defined by .ASKN, .SETN, .SETO, or .SETD.) 


e A character string to define a string symbol 
(Defined by .ASKS, .READ, or .SETS.) 


4.4.1 Special Symbols 


Indirect automatically defines special symbols dependent upon specific 
system characteristics and the replies to queries presented during 
command file execution. As with symbols, special symbols can be 
compared, tested, or substituted and have three types: logical, 
numeric, and string. All special symbols have a common format: angle 
brackets (<>) enclose the special symbol name. 


4.4.1.1 Special Logical Symbols - The special logical symbols are. 
assigned a true or false value under the following circumstances: 


Symbol Value 

<ALPHAN> Set to true if last string entered in response to an 
-ASKS directive or tested with a .TEST directive 
contains only alphanumeric characters. An empty 


string also sets <ALPHAN> to true. 


<ALTMOD> Set to true if last question was answered with an 
ALTmode or ESCape. Otherwise, <ALTMOD> is set to 
false. 

<BASLIN> Set to true if the current operating system is a 


baseline configuration. (This option is used during 
system generation to determine what resources are 
available for the system generation process.) 
Otherwise, <BASLIN> is set to false. 


<DEFAUL> Set to true if answer to last query was defaulted 
(the RETURN key was pressed once) or a timeout 
occurred. 


<EOF> Set to true if the last .READ or .ASKx directive 
resulted in reading past the end of the file. 
Otherwise, <EOF> is set to false. 


<ERSEEND> Set to true if any of the following conditions are 
true (<ERRNUM>, <EXSTAT>, and <FILERR> are described 
in “SGGCION: 42.45 Le2)% 


e <FILERR> is less than 0, if a negative error code 
was returned 


<ESCAPE> 


<FALSE> 


<IAS> 


<LOCAL> 


<MAPPED> 


<NUMBER> 


<OCTAL> 


<PRIVIL> 


<RAD50> 
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e If an exit status (<EXSTAT>) value worse than 
<WARNING> was returned 


e <EOF> is set to true 
e <ERRNUM> is not 0 
e If you used the command line .SETT <ERSEEN> 


The command line .SETF <ERSEEN> sets the following 
conditions: 


e <FILERR> is set to 0 
e <EXSTAT> is set to 0 
e <EOF> is set to false 
e <ERRNUM> is set to 0 


Set to true if last question was answered with an 
ALTmode or ESCape. Otherwise, <ESCAPE> is set to 
false. 


Logical constant used for comparisons with the .IF 
directive or as a default for the .ASK directive. 


Set to true if the current operating system is IAS. 
Otherwise, <IAS> is false. Always false in an 
RSX-11M/M-PLUS system. 


Set to true if the terminal from which Indirect is 
executing (TI:) is a local terminal. If the terminal 
is remote, <LOCAL> is set to false. 


Set to true if the system on which Indirect is 
running is mapped; set to false if the system is 
unmapped. Always true in an RSX-11M-PLUS system. 


Set to true if the last string entered in response to 
an .ASKS directive or tested with a .TEST directive 
contains only numeric characters. An empty string 
also sets <NUMBER> to true. 


Set to true if the answer to the last .ASKN directive 
or the radix of the numeric symbol tested in the last 
-TEST directive is octal or if the last string tested 
with a ~ TEST directive contained all numeric 
characters in the range 0 through 7. 


Set to true if the current user is’ privileged. Its 
value is determined from the flag contained in the 
terminal data base. The flag is set at login or with 
the MCR SET /PRIVilege command. 


Set to true if last string entered in response to an 
-ASKS directive or tested with a .TEST directive 
contains only Radix-50 characters. Radix-50 
characters are the uppercase alphanumeric characters 
plus period (.) and dollar sign ($). A blank is not 
a Radix-50 character in this context. An empty 
String also sets <RAD50> true. 
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<RSX11D> Always false in an RSX-11M/M-PLUS system. 
<TIMOUT> Set to true if timeout mode is enabled and the last 
-ASKx directive timed out waiting for a user 


response. 


<TRUE> Logical constant used for comparisons with the .IF 
directive or as a default for the .ASK directive. 


4.4.1.2 Special Numeric Symbols - The special numeric symbols are 
assigned the following values: 


Symbol Value 


<ERRCTL> Controls the way in which Indirect processes errors. 
The symbol is treated as an 8-bit mask. For each 
class of error that a user's .ONERR target routine 
processes (see Section 4.6.21), the appropriate bit 
is set in the mask. If the bit is clear, Indirect 
exits after printing the error information. 


Tf the eighth bit, which is the sign bit or 200(8), 
is set, Indirect does not print any information about 
the error. 


The initial default value for <ERRCTL> is 1, which 
implies that only class 1 errors can be handled with 
an .ONERR address and that error messages will be 
printed. Note that if you attempt to trap errors 


other than default class Il, processing cannot 
continue in most cases. The error service routine is 
limited to a fatal error message and .EXIT. The 


internal state of Indirect is indeterminate in all 
but class 1 error cases. 


See Section 4.8 for a list of error messages and 
their assigned class values. 


<ERRNUM> Assigned the class number of an error that Indirect 
has finished processing. This value can be used for 
processing specific error types with an - ONERR 
routine. 


See Section 4.8 for a list of error messages and 
their assigned class numbers. 


<ERRSEV> Assigned the error severity mask associated with the 
error that Indirect has finished processing. This 
bit mask corresponds to the bit mask <ERRCTL> used to 
control the processing. 


<EXSTAT> Assigned the value of 0, 1, 2, 4, or 17 depending on 
the exit status from the last CLI command line 
executed or from the last .WAIT taskname directive 
where taskname was activated by the .XQT directive. 


<FILERR> 
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This special numeric symbol is modified at the 
completion of a synchronous CLI command line or at 
the completion of a .WAIT directive. The .EXIT 
directive can also modify <EXSTAT>. The value is 
returned from the task that has completed if the task 
exits with status. Otherwise, the value is returned 
from the CLI. The values 0, 1, 2, 4, and 17 #£=and 
their corresponding special symbols indicate: 


0 <WARNIN> Warning 

1 <SUCCES> Success 

2 <ERROR> Error 

4 <SEVERE> Severe error 

17 <NOSTAT> The task could not return 


exit status. 


Assigned the FCS-11 or I/0 driver status code 
resulting from a -TESTFILE, .OPENx, or .READ 
directive operation. See the RSX-11M/M-PLUS 1/0 
Drivers Reference Manual for a description of the 
codes. 


<FORATT> 


<MEMSIZ> 


<SPACE> 


<STRLEN> 


<SYMTYP> 


<SYSTEM> 


<SYUNIT> 


<TLOLPP> 


Assigned the octal value of the file attributes that 
were used to open the data files. 


Assigned the value of the current system memory size 
in K words (K is 1024.). 


Assigned the number, in octal, of free bytes in the 
internal symbol table for Indirect. The number does 
not reflect the amount of space that could be gained 
by the automatic extension of the Indirect task. 


Assigned the length of the string entered in response 
to the last .ASKS directive or the string tested by 
the last .TEST directive. The symbol is also set 
when a command file is invoked (<STRLEN> contains the 
number of variables used in the command line) and as 
the result of a .PARSE statement. 


Assigned the numeric code for the type of symbol 
tested with a .TEST directive. The symbol types have 
the following code numbers: 


String - 4 
Numeric - 2 
Logical - 0 


Assigned an octal number to represent the operating 
system on which Indirect is running. The value 1 is 
for an RSX-11M_ system; the value 6 is for an 
RSX-11M-PLUS system. 


Assigned the unit number of the user's default device 
(SY:). 


Assigned the current page length setting for the 
terminal. Indirect attempts to determine the length 
when you first invoke it. If the information is not 
available, <TICLPP> defaults to 24(10). 
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<TICWID> Assigned the current page width setting for the 
terminal. Indirect attempts to determine the width 
when you first invoke it. If the information is not 
available, <TICWID> defaults to 80(10). 


<TISPED> Assigned the baud rate for transmitting characters 
from the host system to the terminal. Indirect 
attempts to determine the baud rate when you first 
invoke tt. This information is useful for 
determining the quality and quantity of information 
to be transmitted. The following list gives the 
octal value that corresponds to the baud rates: 


1 0 L3 1200 
2 50 14 1800 
3 75 15 2000 
4 100 16 2400 
5 110 se 3600 
6 134 20 4800 
7 150 21 7200 
10 200 22 9600 
id 300 23 EXTA 
12 600 24 EXTB 
<TITYPE> Assigned the terminal type of the terminal from which 


Indirect is running. Indirect attempts to determine 
the terminal type when you first invoke it. Tf the 
attempt fails, <TITYPE> is set to zero (0). See the 
RSX-11M/M-PLUS I/O Drivers Reference Manual for a 
list of the values that correspond to the terminal 
types. 


4.4.1.3 Special String Symbols - The special string symbols are 
assigned the following string values. 


Symbol Value 


2) secounting 


4-12 


<CLI> 


<CONFIG> 


<DATE> 


<EXSTRI>D 


<FILATR> 


<FILSPC> 


<FMASK> 
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Assigned the acronym (3 through 6 letters) of the 
current command line interpreter (for example, DCL or 
MCR). 


Contains the parameter defaults specified when the 
current Indirect task was built. See the module INDCFG 
in the system procedure library LB:[1,2]INDSYS.CLB for 
more details. 


Assigned the current date; format is dd-mmm-yy. 


When Indirect is first initiated, contains build-time 
information about the Indirect task. The information 
includes the version number of the task and the time 
the task was built. Afterwards, contains the string 
results from a more deeply nested indirect command 
file. The results are sent to the calling command 
file. 


Assigned the seven words of file attribute information 
contained in the FCS-11 File Descriptor Block (FDB). 
The information is from the FDB used in the last .OPENx 
operation. See the IAS/RSX-11 I/O Operations Reference 
Manual for a description of file attributes and the 
values of each field. 


Assigned the fully qualified specification for the file 
referred to with the last .OPEN, .OPENA, .OPENR, or 
-TESTFILE directive operation, or in the last 
specification for a nested command file. 


Contains octal values representing answers to some of 
the system generation questions. Refer to the module 
INDSFN in the system procedure library 
LB: [1,2] INDSYS.CLB for an explanation of the values. 
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<LOGDEV> Assigned the device name and unit number of the user's 
login account on multiuser protection systems. On 
other systems, <LOGDEV> is assigned SyY0: (the system 


device). 
<LOGUIC> Assigned the login UIC of the current user on multiuser 
protection systems; format is [ggg,mmm]. On other 


systems, <LOGUIC> is assigned the current default UIC. 


<NETUIC> Assigned the UIC in which DECnet-related tasks are 
stored on the system volume; format is [ggg,mmm]. 
<NETUIC> is used with <SYSUIC> and <LIBUIC> to separate 
the components of the system. 


<NETNOD> Assigned the DECnet node name of the system. If the 
system is not on the DECnet system, <NETNOD> is 
assigned RSX1l. 


<NXTSYM> Used as part of a dump routine in the command library 
file LB:{1,2]INDSYS.CLB. This is a DIGITAL-supplied 
symbol and it is highly recommended that you not use 


5 ae 

<SYSDEV> Assigned the physical name for the boot device for the 
system. The device name is in the form ddn. 

<SYDISK> Assigned the device mnemonic (two letters) of the 
user's default device (SY:); format is dd. 

<SYSID> Assigned the operating system's baselevel number. 

<SYSUIC> Assigned the system UIC; format is [ggg,mmm]. 

<TIME> Assigned the current time; format is hh:mm:ss. 

<UIC> Assigned the current UIC; format is [ggg,mmm]. 


4.4.2 Numeric Symbols and Expressions 


A numeric symbol is a string of digits representing a value in the 
range of 0O through 177777(8) (0 through 65535 decimal if immediately 
followed by a period or if decimal mode has been enabled). If an 
arithmetic operation yields a result outside of this range, a fatal 
error occurs and the message 


AT. -- NUMERIC UNDER- OR OVERFLOW 
is displayed. 


A numeric symbol or constant may be combined with another numeric 
symbol or constant by a logical or arithmetic operator to form a 
numeric expression. Arithmetic operators are used to add (+), 
subtract (-), multiply (*), and divide (/). Logical operators are the 
inclusive OR (!), logical AND (&), and NOT (#). No embedded blanks or 
tabs are permitted between operators. 
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Numeric expressions are evaluated from left to right unless 


parentheses are used to form subexpressions that are evaluated first. 
For example, the directive lines: 


~-SETN Nl 2 
~-SETN N2 3 
-SETN N3 N1+N2*4 


assign numeric symbol N3 the value 24(8) whereas the directive lines 


.SETN Nl 2 
.SETN N2 3 
.SETN N3 N1+(N2*4) 


assign numeric symbol N3 the value 16(8). 


Numeric expressions are permitted as second operands in numeric .IF 
and .SETN directives. They are also permitted as range and default 
arguments in .ASKN and .ASKS directives. The directives .EXIT and 
-STOP permit numeric expressions to represent exit status. 


With each numeric symbol, Indirect associates a radix -- either octal 
or decimal. The radix of a numeric symbol changes each time the 
symbol is assigned a new value. If you use a numeric expression to 
assign a new value to a symbol and all operands in the expression are 
octal, then the symbol is set to octal. If any operand in the 
expression is decimal, the symbol is set to decimal. For example: 


~-SETN Nl 2 
-SETN N2 3. 
~SETN N3 N1+3 
~-SETN N3 N1+3. 
-SETN N3 N1+N2 


Nl is octal 
N2 is decimal 
N3 is octal 
N3 is decimal 
N3 is decimal 


You can also assign a new value to a symbol with the .ASKN directive. 
See Section 4.6.3 for more information. 


The .SETO and .SETD directives allow you to change the radix of a 
numeric symbol without changing the value of the symbol. For example: 


~-SETN Ni 10. 
-SETO Nl 


Nl 
Nl 


10 decimal 
12 octal 


! 
! 


See Section 4.6.31 for more information on .SETO and .SETD. 


The radix of a numeric symbol does not affect arithmetic operations or 
comparisons. The radix is important only when substituting a numeric 
symbol into a string. If the radix of the symbol is octal, the value 
of the symbol is substituted into the string as an octal number. If 
the radix is decimal, the value is substituted as a decimal number. 
For example: 


~SETN Nl 10. Nl = 10 decimal 


' 
; Nl = 'N1' ! Displayed as ; Nl = 10 
soEloO Ni ! Make N1 octal 
; Nl = 'N1' ! Displayed as ; Nl = 12 
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If you substitute a numeric symbol into a string and the _ substituted 
number is decimal, a period (.) following the symbol name causes a 
trailing period to be included in the string (following the 
substituted number). For example: 


~SETN Nl 10. N1 = 10 decimal 


] 
; Nl = 'N1.' ! Displayed as ; Nl = 10. 
-SETO Nl ! Make Nl octal 
; Ni = 'N1.' ! Displayed as ; Nl = 12 


You can also force a numeric symbol to be substituted as an octal or 


decimal number by using a substitution format control string. For 
example: 


~SETN Nl 10. ! Nl = 10 decimal 
; Nl = 'N1$D' ! Displayed as 
— ! 


: N 10 
; N1 "N1%0' Displayed as ; N 


1 
1 rZ 


See Section 4.4.5.1 for more information on substitution format 
control strings. 


4.4.3 String Symbols, Substrings, and Expressions 


A string constant is a string of any printable characters enclosed by 
quotation marks. Empty strings are also permitted. The number of 
characters cannot exceed 132(10). For example: 


"ABCDEF" 


String symbols may have the value of any string constant. The value 
is assigned by a .SETS or .ASKS directive. For example, the directive 
statements 


- SETS Sl "ABCDEF" 
~SETS $2 Sl 


assign string symbol S2 the value of string symbol Sl (that is, 
ABCDEF). 


A substring facilitates the extraction of a segment from the value of 
a string symbol. You can use substrings only in second operands of 
-SETS and .IF directives. For example, the directive statements 


-SETS Sl "ABCDEF" 
-SETS $2 $1[1:3] 


assign string symbol S2 the value of string symbol Sl beginning at 
character one and ending at character three (that is, ABC). 


You can also use the syntax [n:*] to extract the characters’ from 
position n to the end of the string. For example, the directive 
statements 


i “ABCDEF" 
2 BELSES 


assign string symbol S2 the value CDEF. 
You can combine a string constant, symbol, or substring with another 


String constant, symbol, or substring by the string concatenation 
operator (+) to form a string expression. 


THE INDIRECT COMMAND PROCESSOR 


String expressions are permitted as second operands in .SETS and .IF 
directives where the first operand is a string symbol. For example, 
the directive statements 


-SETS Sl "A" 
~SETS $2 "CDEF" 
- SETS $3 S1+"B"4+S2[1: 3] 


assign string symbol S3 the value of the concatenation of string 


symbol Sl, string constant "B", and the first three characters of 
string symbol S2 (that is, ABCDE). 


4 
Ay - 
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Parameters for a command file can be passed to Indirect for 
processing. The parameters are stored in the following reserved local 
symbols: 


PO, Pl, P2, P3, P4, P5, P6, P7, P8, P9, COMMAN 


The symbol COMMAN contains everything in the issuing command line, 
including the specification for the command file. The symbols PO 
through P9 contain individual elements of the command line. The 
elements are delimited by spaces. 


With the .GOSUB directive (see Section 4.6.16), any parameters to the 
right of the label and to the left of a comment are transferred to the 
symbol COMMAN. The value of COMMAN can then be parsed to obtain 
formal call parameters. 


4.4.5 Symbol value Substitution 


Substitution can occur in any command line. Indirect can use the 
values assigned to logical, numeric, string, or special symbols by 
replacing a normal parameter (for example, a device unit) with the 
symbol name enclosed in apostrophes (for example, 'DEV'). When a 
previous directive has enabled substitution mode (. ENABLE 
SUBSTITUTION), Indirect replaces the symbol name enclosed in 
apostrophes with the value assigned to the symbol. 


When Indirect encounters an apostrophe, it treats the subsequent text, 
up to a second apostrophe, as a symbol name. Indirect then searches 
the table of symbols for the corresponding symbol and substitutes the 
value of the symbol in place of the symbol name and surrounding 
apostrophes in the command line. 


For example, the first three lines in the following example appear in 
an indirect command file. When the processor executes these lines, it 
displays the last two lines at the entering terminal. 


-ASKS DEV MOUNT ON DEVICE? 
- ENABLE SUBSTITUTION 
MOUNT 'DEV' 


>* MOUNT ON DEVICE? [S]: DK2: 
>MOUNT DK2: 
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DK2: was entered in response to the displayed question. This reply 
assigned the string value DkK2: to string symbol DEV. Then when 
Indirect read: 


MOUNT 'DEV' 


it substituted for 'DEV' the value assigned to DEV (that is, DK2:). 
If substitution mode was not enabled, Indirect would simply have 
passed the line to the CLI as it appeared in the command file (that 
is, MOUNT 'DEV'). 


If substitution mode is enabled, an apostrophe signals the beginning 
of a string symbol. Thus, to include a single quote as text within a 
command line, rather than as the start of a symbol, you must’ replace 
the single quote with two contiguous apostrophes (''). 


If substitution mode is enabled, Indirect displays the command file 
line 


! DON''T SHOOT 
as 


! DON'T SHOOT 


4.4.5.1 Substitution Format Control - The conversion of numeric 
values to strings and the placement of string and logical values ina 
substitution operation can be controlled with a format control string. 
The control string is in the following form: 


---'symbol%controlstring'... 


The control string begins with the percent sign (%) and ends with the 
second of the two apostrophes that denote the substitution operation. 
The control string consists of one or more of the following 
characters: 


Cc Compress leading, embedded, and trailing blanks, and remove 
embedded nulls. 


D Force the conversion of a numeric symbol to decimal. 

8) Force the conversion of a numeric symbol to octal. 

S Perform signed conversion for a numeric symbol. 

M Perform magnitude conversion for a numeric symbol. 

Z Return leading zeros for a positive numeric value. 

Rn Right-justify the resulting string, truncating to ‘nh 


decimal characters if necessary. 


Ln Left-justify the resulting string, truncating to 'n' decimal 
characters if necessary. 


xX Convert the variable to Radix-50 characters. 


V If the symbol being substituted is numeric, convert the low 
byte to its equivalent ASCII character and substitute it. 
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If the symbol being substituted is a string, convert’ the 
first character to its octal representation and substitute 
it. 


Indirect does not perform a consistency check on the control string. 
If you specify conflicting format characters, Indirect uses the last 
one specified. 


4.5 SWITCHES 


The indirect command processor accepts six switches: /TR, /DE, /MC, 
/CLI, /LB, and /LO. 


Switch Function 


/(NO]TR Displays a trace of the indirect command file on _ the 
entering terminal. This function is useful for 
debugging an indirect command file. Each command line, 
including Indirect directive statements, is displayed. 
As each Indirect command line is processed, a number 
representing the nesting depth of the command file is 
displayed, followed by an exclamation mark and_ the 
command line. If the command line causes some action 
to occur, the next printed line indicates the action; 
usually, this line consists of the CLI commands issued 
as a result of the previous directive. The default is 
/NOTR. 


/{NO]DE Indicates that the indirect command file is to be 
deleted when its processing is complete unless a 


logical end-of-file (/) or -STOP directive is 
encountered before the end of the file. The default is 
/NODE. 


/{NO]MC PasseS commands not processed by Indirect to _ the 
default command line interpreter (CLI) for your 
terminal. This switch is synonymous with /[NO]CLI. 
The default is /MC. 


/{NO]JCLI PasseS commands not processed by Indirect to. the 
default command line interpreter (CLI) for your 
terminal. This switch is synonymous with /[NO]MC. The 
default is /CLI. 


/LB Indicates that the specified file is a universal 
library of command procedures and that the specified 
module is the procedure to be executed. 


When command procedures, which are indirect command 
files, are inserted into a universal library with the 
Librarian Utility Program (see _ the RSX-11M/M-PLUS 
Utilities Manual), you can then reference them with 
/LB:module. 


Command libraries are built by creating a _ universal 
library and inserting command files into it. You can 
then reference the procedures in the library with the 
following command line: 


@command-library/LB:module 
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The default file type for a command library is .CLB. 


If you do not specify a module (@command-library/LB) , 
Indirect attempts to locate a module called .MAIN.. 


If you do not specify a library name (@/LB:module), the 
following actions occur: 


e If the command is issued from the terminal or 
from a file that is not in the library, 
Indirect ignores the /LB switch and treats’ the 
command line as though you had used 
@module.CMD. Note that if the command is 
issued from a command file, the default device 
and directory of the specified module are _ the 
same as those for the current file, not 
necessarily the same as those for the terminal. 


e If the command was issued from within a 
library, the specified module is searched for 
in the current library. 


These default actions for an unspecified library allow 
a collection of procedures to be developed in a given 
directory with the @/LB:module or .CHAIN /LB:module 
commands. When the procedures are then placed ina 
library, no source changes are required. 


Example: 


The command file PARAM.CMD contains parameter 
definitions for the .SETN directive and _ the 
command file SYSPRC.CMD contains system-specific 
procedures. Use the following command lines to 
create the command library and enter the command 
files into it: 


LBR>SYSTART.CLB/CR::::UNI:CMD 
LBR>SYSTART.CLB=PARAM/IN: PARAM 
LBR>SYSTART.CLB=SYSPRC/IN: PROCED 


You can then use the following command lines to 
reference the command library modules: 


@SYSTART/LB: PARAM !Define global symbols 
@SYSTART/LB: PROCED !Run init procedure 


DIGITAL supplies a library of command procedures. The 
library is LB:[{1,2]INDSYS.CLB and it contains the 
foliowing procedures: 


INDCFG Displays the current build parameters 
for the running Indirect task. 


INDDMP Dumps to the terminal the contents of 
the Indirect symbol table. 


INDPRF A sample procedure to fully parse 
file-name strings. 


INDSFN Returns system configuration 
information. 
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INDVFY Displays the values of all of the 
special symbols. 


QIOERR Returns a string expansion of the 
<FILERR> error codes. 


.- INDEX Displays an index of the procedures in 
the library. 


The following command line shows the format for 
invoking a command procedure in the library: 


@LB: [1,2] INDSYS/LB:procedurename 


Before you attempt to access a command procedure, make 
sure that INDSYS.CLB is in LB:[{1,2]. If it is not in 
this directory, your system manager must copy the 
library off of _the source kit for the system. {On 
-RSX-11M,. th a ncluded with the source files = 
cfor: MCR, 2; 10) .). “aenoeniee 


/{NO]LO Indicates that when a new command file is executing, it 
can have access to the local symbols created by its 
calling command file, and that any local symbols 
created by the new command file will be defined as 
local symbols for the calling command file. The 
default is /NOLO. 


Use any combination of the switches in the command line 
@filename/switches 
or directive statement 
-CHAIN filename/switches 
The switches you specify in the terminal command line that initiates 
Indirect processing are used as defaults when executing the following 
commands: @filename[/switches] or .CHAIN filename[/switches]. This 


does not apply, however, for the /DE switch; the default is always 
/NODE. 


4.6 DESCRIPTION OF INDIRECT DIRECTIVES 
Directives must be separated from their arguments and from 


CLI-specific commands by at least one space. Only one directive per 
command line is allowed. 


4-21 April 1983 
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You can insert any number of blanks and horizontal tabs in three 
places of a command line: 


e At the start of the command line 
e Immediately following the colon (:) of a label 
@® At the end of the command line 


This allows you to format the command files for readability. The 
recommended procedure is to begin labels in column one and everything 
else in column nine (after one horizontal tab). 


An important exception is the lines processed between .ENABLE and 
-DISABLE DATA directives; no blanks or tabs are removed from these 
lines. For example: 


~IFT Z .GOTO 10 
MAC @ASM 
10: TKB @BLD 
~OPEN DATFIL 
~-DATA XXXXX 
~ENABLE DATA 
This is data 
that goes into 
the data file. 
-DISABLE DATA 
-GOTO 20 


Note that the .DISABLE DATA statement must begin in column 1 ofr 
Indirect will place it in the data file. You can also use the .CLOSE 
directive in place of .DISABLE DATA. It too must begin in column 1. 


Pose 


-label: 


Fi 
Labels always appear at the beginning of the line; they may be__on a 
line with additional directives and/or a CLI command, ona line with a 
comment, or on a line by themselves. When control passes to a line 
with a label, the line is processed from the first character after the 
colon. 


4.6.1 Define a Label 


Commands do not have to be separated from the label by a space. Only 
one label is permitted per line. Labels are one through six 
characters in length and must be preceded by a period and terminated 
by a colon. A label may contain only alphanumeric characters and/or 
dollar signs (S$). 


It is also possible to define a label as a direct access label; once 
the label is found, its position in the command file is saved. This 
allows subsequent jumps to frequently called labels or subroutines to 
be effected quickly. The first statement processed after a jump to a 
direct access label is the one on the next line. The maximum number 
of direct access labels you can define within an indirect command file 
depends on the version of the Indirect task you are using. (The 
maximum number is specified in the task build file.) If you define 
more than the maximum number allowed, the subsequent direct access 
labels replace the earliest and so on. The smaller the number of 
direct access labels, the larger the amount of free symbol table 
space. 


To declare a label for direct access, leave the line following the 
colon blank. 
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Examples: 


NAN « A 
e LUV e6 oh 


- 200: 


-;THIS IS THE START OF A SUBROUTINE 


- RETURN 


4.56.2 Ask a Question and Wait for a Reply 


The .ASK directive prints a question on the terminal, waits for a 
reply, and sets a specified logical symbol to the value of true or 
false, depending on the reply. If the symbol has not already been 
defined, Indirect makes an entry in the symbol table. If the symbol 
has been defined, Indirect resets its value (true or false) in 
accordance with the reply. Indirect exits with a fatal error if the 
symbol was previously defined as a string or numeric symbol. 


Formats (brackets are required syntax): 


-ASK ssssss txt-strng 
-ASK [default:timeout] ssssss txt-strng 
-ASK [:timeout] ssssss txt-strng 


where: 


ssssss The 1- to 6-character symbol to be assigned a true or 
false value. 


txt-strng The question or prompt that Indirect displays. 


default The default response; used if the question is 
answered with an empty line (null) or if timeout 
occurs. The default can be <TRUE> or <FALSE> or 
another logical variable. 


timeout The timeout count. Indirect waits this long for a 
response, then applies the default answer. The 
format for timeout is nnu, where nn is the decimal 
number of time units to wait and u is T (ticks), §S 
(seconds), M (minutes), or H (hours). The timeout 
count is valid only if timeout mode is enabled 
(.ENABLE TIMEOUT). 


The entire .ASK statement must fit on one command line. 


Note that if you omit the default value but specify a timeout count, 
the colon is required for positional identification. 
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When executing an .ASK directive, Indirect displays txt-strng prefixed 
by an asterisk and suffixed with "? [Y/N]:". Indirect recognizes five 
answers: > 


1. Y ED Set symbol ssssss tio true 
2. N@E Set symbol ssssss to false.) 
mr cen we ae 
34. GD Set symbol to false or to user-specified default 


value. RET indicates the RETURN key. 


4. € Set symbol ssssss to true and set the special 
logical symbol <ESCAPE> to true only if escape 
recognition has been enabled. ESQ) indicates 


the ESCAPE or ALTMODE key. 


5. GR If Control-Z mode is enabled, set <EOQF> to true 
and proceed, else exit immediately. 


Example: 
The directive statement 

-ASK INSPIP DO YOU WANT TO INSTALL PIP 
displays 

>* DO YOU WANT TO INSTALL PIP? [Y/N]: 


on the terminal. Symbol INSPIP will be set to true or false after you 
type Y, N, the RETURN key, or the ESCAPE key (if escape recognition is 


enabled). 

{ \ 
4.6.3 Ask for Definition of a Numeric Symbol ' .ASKN : 
The .ASKN directive prints on the terminal a request for a meee 
value, waits for it to be entered, optionally tests the range for the 
numeric response and/or applies a default value, and sets’ the 
specified symbol accordingly. If the symbol has not previously been 
defined, Indirect makes an entry in the symbol table. If the symbol 
has already been defined, Indirect resets its value in accordance with 
the reply. Indirect exits with a fatal error if the symbol was 
previously defined as a logical or string symbol. 


Formats (brackets are required syntax): 


-ASKN ssssss txt-strng 
-ASKN [low:shigh:default:timeout] ssssss txt-strng 


where: 


ssssss The 1- to 6-character symbol to be assigned a numeric 
value. 


-txt-strng The question or prompt that Indirect displays. 


low:high A numeric expression giving the range _ for the 
response. 


default A numeric expression or symbol giving the default 
value. 
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timeout The timeout count. Indirect waits this long for a 
response, then applies the default answer. The 
format for timeout is nnu, where nn is the decimal 
number of time units to wait and u is T (ticks), §S 
(seconds), M (minutes), or H_ (hours). The timeout 
count is valid only if timeout mode is enabled 
(.ENABLE TIMEOUT). 


The entire .ASKN statement must fit on one command line. 


Note that if you omit any of the parameters within the square 
brackets, any preceding colons are required for positional 
identification. 


The command line cannot exceed 132(10) characters in length. When 
executing an .ASKN directive, Indirect displays txt-strng prefixed by 
an asterisk and suffixed with [0]: to indicate that the response is 
considered as octal or [DJ]: to indicate that the response is 
considered as decimal. The reply must be a number either within the 
specified range or in the range 0 through 177777(8) (by default) or 0 
through 65535(10). 


If the response is outside the specified range, the message 
AT. -- VALUE NOT IN RANGE 
is displayed and the query repeated. 


If an arithmetic operation yields a result greater than 177777(8) when 
computing the actual value of any of the arguments (low, high, or 
default), a fatal error occurs and the message 


AT. -- NUMERIC UNDER- OR OVERFLOW 
is displayed. 


If the response is an empty line (null) and a default value (default) 
was not specified, Indirect applies a default of 0. Note that in this 
case, the range, if specified, must include 0. 


The response may be either octal or decimal; a leading pound sign (#) 
forces octal, a trailing period (.) forces decimal. In the absence of 
both, Indirect applies a default radix. The default radix is decimal 
if either the range or default values are decimal expressions 
(followed by a period). Otherwise, the default radix is octal (unless 
decimal mode has been enabled). Indirect displays the default type as 
either [0] or [D]. 


To force a default decimal radix without specifying a range argument, 
use the following construction: 


-ASKN [::0.] A ENTER VALUE 
or 


- ENABLE DECIMAL 
-ASKN A ENTER VALUE 
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Examples: 
e The directive statement 
-ASKN SYM DEFINE NUMERIC SYMBOL A 
displays 
>*DEFINE NUMERIC SYMBOL A [0]: 
on the terminal where: 
[O] is the default radix (octal). 


Indirect then defines symbol SYM according to the reply 
entered. 


e The directive statement 
-ASKN [2:35:16:20S] NUMSYM DEFINE NUMERIC SYMBOL A 
displays 
>* DEFINE NUMERIC SYMBOL A [0 R:2-35 D:16 T:20S]: 
in the format [x R:low-high D:default T:timeout] 
where: 


X O if the default radix is octal or Dif it is 
decimal. 


R:low-high The specified range. 
D:default The specified default. 


T:timeout The specified timeout count before the 
default answer is applied. 


Indirect then checks that the response string is in the 
specified range. 


e The directive statement 


-ASKN [NUMSYM+10:45:NUMSYM+10] SYM DEFINE NUMERIC SYMBOL B 
displays (assuming the value of 16 octal for NUMSYM) 


>* DEFINE NUMERIC SYMBOL B [O R:26-45 D:26]: 


4.6.4 Ask for Definition of a String Symbol - ASKS 


The .ASKS directive prints on the terminal a request for a_e string 
value to define a specified symbol and optionally tests that the 
number of characters in the response string falls within the specified 
range. If the symbol has not previously been defined, Indirect makes 
an entry in the symbol table. If the symbol has already been defined, 
Indirect resets its value in accordance with the reply. Indirect 
exits with a fatal error if the symbol was defined previously as a 


THE INDIRECT COMMAND PROCESSOR 
logical or numeric symbol. If the number of characters is out of the 
specified range, the message 
AT. -- STRING LENGTH NOT IN RANGE 
is displayed and the question repeated. 
Formats (brackets are required syntax): 


-ASKS ssssss txt-strng 
-ASKS [low:shigh:default:timeout] ssssss txt-sStrng 


where: 


ssssss The 1- to 6-character symbol to be assigned a_ string 
value. 


txt-strng The question or prompt that Indirect displays. 


lowshigh A numeric expression giving the range for the number 
of characters permitted in the response string. 


default A string expression or symbol giving the default 
value. 

timeout The timeout count. Indirect waits this long for a 
response, then applies the default answer. The 


format for timeout is nnu, where nn is the decimal 
number of time units to wait and u is T (ticks), S 
(seconds), M (minutes), or H (hours). The timeout 
count is valid only if timeout mode is enabled 
(.ENABLE TIMEOUT). 


The entire .ASKS statement must fit on one command line. 
Note that if you omit any of the parameters within the square 
brackets, any preceding colons are required for positional 
identification. 
When executing an .ASKS directive, Indirect displays txt-strng 
prefixed by an asterisk (*) and suffixes it with [S]:. The reply must 
be an ASCII character string. 
Examples: 
e The directive statement 
-ASKS NAM PLEASE ENTER YOUR NAME 
displays 
>* PLEASE ENTER YOUR NAME [S]: 


on the terminal. Indirect then defines symbol NAM according 
to the string reply entered. 
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e The directive statement 
-ASKS [1:15::10S] MIDNAM PLEASE ENTER YOUR MIDDLE NAME 
displays 
>* PLEASE ENTER YOUR MIDDLE NAME [S R:1-15 T:10S]: 
in the format [S R:low-high T:timeout] 
where: 
S The symbol type (string). 
R:low-high The specified range for number of characters. 


T:timeout The specified timeout count. 


4.6.5 Begin Block BEGIN 


The .BEGIN directive marks the beginning of a Begin-End site hae? 
block must be terminated with an .END directive. 


Labels and local symbols defined following the .BEGIN directive are 
local to the block instead of being used throughout the entire command 
file. Therefore, labels and local symbols defined inside a block lose 
definition outside the block. (Labels and symbols defined outside a 
block retain definition throughout the file.) Labels and _ symbols 
defined outside a block and then modified within the block, however, 
assume and retain the value assigned in the block. 


Labels and local symbols defined within a block lose definition with 
an .ERASE LOCAL directive statement (see Section 4.6.14) or with the 
-END directive 


-BEGIN must be the only directive on a command line. For example, the 
-BEGIN directive cannot appear on the same line as an .IF directive. 


Format: 
- BEGIN 


as the only directive on the line. 


4.6.6 Continue Processing Using Another File ‘ . CHAIN J 


\ we 
The .CHAIN directive closes the current file, erases aly ieee 
symbols, clears any .ONERR arguments, empties the direct access label 
cache, and continues processing using command lines from another file. 
However, the .CHAIN directive does not close data files or change the 
nested-file level. 


Format (brackets not part of syntax): 
CHAIN filename[/switches] 
where filename is the name of the file that contains the new command 


lines and /switches are any of the optional switches described in 
Section 4.5. 
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Example: 
The directive statement 


~CHAIN OUTPUT 


transfers control to the file OUTPUT.CMD. 


4.6.7 Close Secondary File /. CLOSE/ 


The .CLOSE directive closes the secondary file opened by an _ .OPEN 
directive. 


Format (brackets not part of syntax): 


-CLOSE [#n] 


where: 

#n An optional file number in the range 0 to x-1l, where x is 
the number of file-open FDBs specified in the build file 
for the Indirect task. (x is the maximum number of files 
that can be open simultaneously.) The default is #0. You 
can substitute a numeric symbol for the value n by 
enclosing the symbol in apostrophes. 

ye = 
4.6.8 Output Data to Secondary File , «DATA 


The .DATA directive specifies text that is to be output to a secondary 
file previously opened by an .OPEN directive. 


When Indirect processes the text string that follows the .DATA 
directive, it ignores the leading space (if present), assuming it to 


be a separator between the directive and the text string. Any other 
spaces are transferred to the data file. If a TAB follows the 
directive, it is transferred to the file. If no other characters 


follow the directive, a blank line is transferred to the file. This 
processing has the following results: 


Command File Open File 
~DATA foo @ED foo RED 
-DATA’ foo @ED foo RED 
-DATA foo RED foo RED 
. DATA foo RED foo 
- DATA @ED) null line 


Note that if a comment follows a .DATA statement (that is, .DATA 
data !comment), Indirect also outputs the comment to the secondary 
file because it cannot tell if the comment pertains to the .DATA 
statement itself or to the data being output to the file. 


i 
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Format (brackets not part of syntax): 
-DATA [#n] txt-strng 
where: 
txt-strng The text to be output to the secondary file. 


#n An optional file number in the range 0 to x-l, where 
x is the number of file-open FDBs specified in the 
build file for the Indirect task. (x is the maximum 
number of files that can be open simultaneously.) The 
default is #0. You can substitute a numeric’ symbol 
for the value .x by enclosing the symbol in 
apostrophes. 


The command line cannot exceed 132(10) characters and the _ specified 
text string cannot continue onto the next line. If a secondary file 
is not open, an error condition exists; Indirect issueS an error 
message and begins error processing. 

Example: 


-SETS SEND "THIS IS DATA" 


-OPEN TEMP 
DATA 'SEND' 
-CLOSE 


These directives output THIS IS DATA to the secondary file TEMP.DAT 
(.DAT is the default file type for a data file). 


4.6.9 Decrement Numeric Symbol -DEC ) 
The .DEC directive decrements a numeric symbol by one. ge eee 
with a fatal error if the symbol was defined previously as a logical 
or string symbol. 
Format: 

»~DEC ssssss 
where: 

ssssss The 1l- to 6-character numeric symbol. 
Example: 

~DEC X 


This directive decrements by 1 the value assigned to the numeric 
symbol X. 


a 
_cereretemeveme . 
x , ees \, | 
4.6.10 Delay Execution for a Specified Period of Time \ «DELAY // 


\ 
The .DELAY directive delays further processing of the file fora 
specified period of time. 
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Formats: 
-DELAY nnu 
where: 
nn The decimal number of time units to delay. 
u T - ticks 
S - seconds 
M - minutes 
H - hours 


The parameter nn is decimal by default, or octal if preceded by a 
pound sign (#). For example: 


10S is 10(10) seconds 
#10S is 10(8) seconds 


If quiet mode is disabled when the .DELAY directive is executed, 
Indirect issues the message 


AT. -- DELAYING 


When the time period expires and the task resumes, Indirect issues the 
message 


AT. -- CONTINUING 
Example: 
The directive statement 
~DELAY 20M 


delays processing for 20(10) minutes. 


4.6.11 Disable Option ao 


The .DISABLE directive disables a specified operating mode previously 
activated by an .ENABLE directive. See Section 4.6.12 for operating 
mode information. 
Format: 

»~DISABLE option[,option...] 


The following is a list of the operating modes that can be disabled: 


ATTACH DETACH GLOBAL TIMEOUT 
CONTROL-Z DISPLAY LOWERCASE TRACE 

DATA ESCAPE MCR TRUNCATE 
DECIMAL ESCAPE-SEQ OVERFLOW SUBSTITUTION 
DELETE QUIET 


Note that when you disable detach mode from a command file and_ then 
request a task or CLI command to display information, the command file 
may not be able to continue executing. The task or CLI command may 
need to attach to the terminal to display the information but will not 
be able to do so because Indirect cannot detach from the terminal. 
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4.6.12 Enable Option . ENABLE 


The .ENABLE directive is used to invoke several operating modes. Each 
mode is independent of the _ others; all of them can be active 
Simultaneously. When Indirect starts to process a file, the initial 
settings are: 


ATTACH enabled GLOBAL enabled 
CONTROL-Z disabled LOWERCASE enabled 
DATA disabled MCR enabled 
DECIMAL disabled OVERFLOW disabled 
DELETE disabled QUIET disabled 
DETACH enabled SUBSTITUTION disabled 
DISPLAY enabled TIMEOUT enabled 
ESCAPE disabled TRACE disabled 
ESCAPE-SEOQ disabled TRUNCATE disabled 


In attach mode, Indirect attaches to a terminal when displaying 
comment lines. In detach mode, it detaches from the terminal when 
processing command lines. Enabling both of these modes allows you to 
type CTRL/O to suppress a lengthy comment. 


Enabling Control-Z mode allows a command file to detect a CTRL/Z 
response to a question and continue processing. If Control-Z mode is 
disabled and you type cCTRL/Z in response to an .ASKx question, 
Indirect exits. If Control-Z mode is enabled, the special symbol 
<EOF> is set to true and Indirect continues processing the command 
file. 


In data mode, Indirect outputs lines that follow an .ENABLE DATA 
directive statement to a secondary file. (The .DATA directive sends a 
Single line of text to a secondary file; see Section 4.6.8.) To 
disable data mode, the .DISABLE DATA (or .CLOSE) statement must begin 
in the first column. Otherwise, Indirect copies the statement itself 
into the data file. The .ENABLE DATA directive also has an optional 
argument (#n) that specifies which file the data is to go into. See 
the description of the .DATA directive (Section 4.6.8) for more 
information. 


In global symbol mode, symbol names that begin with a dollar sign ($) 
are defined as global to all levels of indirect files; once such a 
symbol has been defined, all levels recognize it. Symbols that do not 
begin with a dollar sign are recognized only within the level that 
defines them. 


In decimal mode, all numeric symbols are created or redefined by 
default as decimal instead of as octal. 


In delete mode, the current command file is deleted when Indirect 
processes the last command line in the file. 


In display mode, Indirect displays the current fields for the .ASKx 
directives and @ <EOF>. If display mode is disabled, Indirect 
displays only the text string for the .ASKx directive and suppresses 
@ <EOF>. 


In MCR mode, commands not processed by Indirect are passed to the 
default CLI of the terminal. The CLI might be MCR, DCL, or a 
user-written CLI. MCR mode is equivalent to the functions of the /CLI 
and /MC switches. 
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In lowercase mode, characters read from the terminal in response to 


-ASKS directives are stored in the string symbol without lower- to 
unnercase conversion. The representation of characters is Significant 


wep pe ee SRS ew eee eeu RS SP ee SH ew ON ES 


when comparing strings (see Section 4.6.18) since the .IF directive 
distinguishes between lowercase and uppercase characters. 


In substitution mode, Indirect substitutes a string for a symbol. The 
symbol must begin and end in apostrophes ('symbol'). For example, if 
the symbol A has been assigned the string value THIS IS A TEST, then 
every 'A' will be replaced by THIS IS A TEST. When substitution mode 
is enabled, Indirect performs substitutions in each line before 
scanning the line for directives and CLI commands. (While obeying a 
-GOTO label directive, however, Indirect ignores any undefined symbols 
encountered before the target line, that is, the line containing the 
specified label.) 


Escape recognition (.ENABLE ESCAPE) permits the response to an  .ASK, 
-ASKN, or .ASKS directive to be an escape character. A question 
answered with a single escape character sets the special logical 
symbol <ESCAPE> to true. The escape character must be used only as an 
immediate terminator to the question; if one or more characters 
precede the escape character, an error condition exists. In this 
case, the message 


AT. -- INVALID ANSWER OR TERMINATOR 


is printed and the question repeated. Note that if you press’ the 
ESCAPE key in response to an .ASK directive, the specified logical 
symbol (ssssss of .ASK ssssss txt-Strng) is also set to true. 


Escape-sequence recognition (.ENABLE ESCAPE-SEQ) forces Indirect to 
attach to the terminal for escape-sequence recognition, using the 
IO.ATTITF.SEQ I/O function. In this mode, the result of an .ASKx or 
-READ statement from the terminal will contain the terminating escape 
character and escape sequence as documented in the full-duplex 
terminal driver chapter of the RSX-11M/M-PLUS I/O Drivers Reference 
Manual. 


Overflow mode allows signed arithmetic in numeric expressions. 
Enabling the mode provides for numeric expressions and operations that 
otherwise would result in the "Numeric under- or overflow" error 
message. 


Quiet mode is valid only in systems that support parent-offspring 


tasking; the directive performs no function in systems that do not 
support parent-offspring tasking. In quiet mode, the processor does 
not echo CLI command lines or comments. The command lines are 


executed normally and, if they return a message or display, the 
message or display is printed on the terminal. 


In timeout mode, Indirect uses the timeout parameters specified with 
the .ASKx directives. Indirect waits for the timeout count to elapse 
and then applies the default answer to the directives. Timeout mode 
must be enabled (the default) to use the timeout counts for the .ASKx 
directives. 


In trace mode, command lines that Indirect has processed are displayed 
on the terminal. As each line is processed, it is displayed with its 
nesting level and an exclamation mark (!). Trace mode is equivalent 
to the function of the /TR switch. 


In truncate mode, Indirect ignores any truncate errors on a_ .READ 
directive. A truncate error occurs when a line in a file is too long. 
Tf the full record cannot fit within the 132(10)-character limit of 
the symbol, the record is truncated. 


Formats 
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(brackets not part of syntax): 


-ENABLE option[,option...] 


»~ ENABLE DATA [#n] 


where: 


#n 


An optional file number in the range 0 to x-1, where x is 
the number of file-open FDBs specified in the build file 
for the Indirect task. (x is the maximum number of files 
that can be open simultaneously.) The default is #0. You 
can substitute a numeric symbol for the value n by 
enclosing the symbol in apostrophes. 


Examples (assuming that MCR is the default CLI for the terminal): 


Substitution mode: 


» ENABLE SUBSTITUTION 
e-ASKS FIL SPECIFY SOURCE FILE 
MAC '‘'FIL'='FIL' 


When the file is executing, the corresponding lines displayed 
at the terminal are: 


>* SPECIFY SOURCE FILE [S]: SOURCE 
>MAC SOURCE=SOURCE 


Global symbol mode: 


The following two lines appear in an indirect command file 
Called. TESTI: 


- ENABLE GLOBAL 
eShlo Sx ? TEST" 


A file called TEST2.CMD contains the following lines: 


»~ ENABLE SUBSTITUTION 
@TESTI 
MAC 'SX','SX'='"SX! 


Therefore, MCR displays the following when the file TEST2.CMD 
is run: 


>MAC TEST, TEST=TEST 
>@ <EOF> 


Escape recognition mode: 


;IF YOU WANT A LIST OF OPTIONS, TYPE <ESC>. 
- ENABLE ESCAPE 

ASKS A ENTER OPTION 

~IFT <ESCAPE> .GOTO LIST 


-LIST: ;OPTIONS ARE: A (ADD), S (SUBTRACT), M (MULTIPLY) 


If you press the ESCAPE key in response to ENTER OPTION, the 
lines displayed at the terminal are: 
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>;IF YOU WANT A LIST OF OPTIONS, TYPE <ESC>. 
>* ENTER OPTION [S]: ESC 
>; OPTIONS ARE: A (ADD), S$ (SUBTRACT), M (MULTIPLY) 


e Quiet mode: 


-ASK QUIET DO YOU WANT COMMAND LINES SUPPRESSED 
-IFT QUIET .ENABLE QUIET 

e-IFF QUIET .DISABLE QUIET 

ACT 


If the response is affirmative, Indirect displays the active 
tasks but not the ACTIVE command. For example: 


>DO YOU WANT COMMAND LINES SUPPRESSED? [Y/N]: Y 
MCR... 

ACTT17 - 

AT.T17 


e Control-Z mode: 


- ENABLE CONTROL-Z 

-ASK RESP DO YOU WISH TO CONTINUE 
-IFT <EOF> .GOTO CLENUP 

-IFF RESP .GOTO CLENUP 


If you type CTRL/Z in response to the question, <EOF> is set 
to true and Indirect transfers to CLENUP. 


= . 
ee ™s a 


4.6.13 End Block / BND 


\ 


The .END directive marks the end of the Begin-End block. If Indirect 
encounters more .END directives than .BEGIN directives, command 
processing terminates and the following message is displayed: 


AT. —-- ILLEGAL NESTING 
Format: 
- END 


as the only directive on the line. 


ch 
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4.6.14 Delete Symbols ae 
The .ERASE directive deletes all local or global symbol definitions, 


or a specific global symbol definition. When you define a symbol, 
either locally (by defining a symbol value) or globally (by enabling 
global symbol mode and preceding the symbol name with a dollar sign 
($)), Indirect creates an entry in the symbol table. The .ERASE 
directive erases either all local or all global entries, or a specific 
global entry, in the table. 


Following an .ERASE directive, you can redefine symbol values as well 
as symbol type. 


Formats: 
eERASE LOCAL 


- ERASE GLOBAL 
. ERASE SYMBOL global-symbol 
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An .ERASE LOCAL directive outside of a Begin-End block erases all 
local symbols defined within the current file. 


An .ERASE LOCAL directive within a Begin-End block erases only those 
local symbols defined within the block. 


However, note that the following actions also occur: 


1. Local symbols defined within a nested file are erased when 
that file exits. 


2. Local symbols defined within a Begin-End block are erased 
with .END. 


3. Local symbols defined outside of Begin-End blocks are 
visible, modifiable, and not erasable within a Begin-End 
block. . 


An .ERASE GLOBAL, either outside of or within a Begin-End block, 
erases all global symbols. 


An .ERASE SYMBOL global-symbol erases the specified global symbol. 
(Individual local symbols are not erasable.) 


Example: 
- ERASE LOCAL 


This directive erases all local symbol definitions used in the 
indirect command file. 


-ERASE SYMBOL SSWITC 


This directive erases the single global symbol "S$SWITC." 


os 
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4.6.15 Exit Current Command File | -EXIT ) 
The .EXIT directive terminates processing of the current Sonmanescete 


or Begin-End block and returns control to the previous-level command 
file or, if the directive is executed within a block, to the line 
following the .END directive. If the directive is encountered at the 
uppermost indirect nesting level, Indirect exits and passes control to 
the CLI (see the .STOP directive, Section 4.6.33). 


The .EXIT directive also allows you to optionally specify a value _ to 
copy into the special symbol <EXSTAT>. 


Format (brackets not part of Syntax): 
-EXIT [value] 


where value is an optional numeric expression to be copied to _ the 
special symbol <EXSTAT>. 


Examples: 
The following line appears in an indirect command file called TESTI: 


@TEST2 
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The file TEST2.CMD contains the following line: 
~BAIT 


When Indirect encounters the .EXIT directive in TEST2, control returns 
to TEST1.CMD. 


If the .EXIT directive in TEST2.CMD includes a numeric expression, for 
example: 


EXIT N+2 


Indirect evaluates the expression and copies the value into <EXSTAT>. 


oe witatrome ‘ 
a + 
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4.6.16 Call a Subroutine fs ae 
The .GOSUB directive saves the current position in an indirect commran 
file and then branches to a label. The label identifies an entry 
point to a subroutine that is terminated by a .RETURN directive. 


When you issue a .GOSUB directive from within a Begin-End block, 
Indirect saves the current block context and then scans down the file 
searching for the first occurrence of the subroutine label. Note that 
during the scan, [Indirect ignores any intervening .BEGIN or .END 
directives. The .RETURN directive restores previous block context. 
Thus, the subroutine can be contained within a Begin-End block. 


The maximum nesting depth for subroutine calls depends on the number 
specified in the build file for the Indirect task. 


Format: 
-GOSUB label parameters 


where label is the label that designates the first line of a 
subroutine, but without the leading period and trailing colon. Any 
parameters to the right of the label and to the left of a comment are 
transferred to the reserved local symbol COMMAN. The value of COMMAN 
can then be parsed with the .PARSE directive (see Section 4.6.25) to 
obtain formal call parameters. 


Example: 
The directive statement 
e~GOSUB EVAL 
transfers control to the subroutine labeled .EVAL:. 
4.6.17 Branch to a Label oe 
a 
The .GOTO directive causes a branch from one line in an  indirYrétt 
command file to another. All commands between the .GOTO directive and 
the specified label are ignored. Branches can go forward or backward 


in the file. 


The target of a .GOTO branch from within a Begin-End block must be 
contained in that block. The .GOTO directive cannot branch into 


another block. When Indirect encounters a .GOTO directive within a 
Begin-End block, it searches for the specified label in that block. 
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Since Indirect only searches the one Begin-End block, you can use the 
same label more than once in a command file. 
Format: 
-GOTO label 


where label is the name of the label, but without the leading period 
and trailing colon. 


Example: 
The directive statement 
-GOTO 100 


transfers control to the line containing the label .100:. 


4.6.18 Logical Test 


A number of directives make tests; if the test is true, Indirect 
processes the remainder of the command line. Logical tests can be 
combined into a compound logical test by using the .AND and .OR 
directives. 


4.6.18.1 Test If Symbol Meets Specified Condition (.IF) - The .IF 
directive compares a numeric or string symbol with another expression 
of the same type to determine if one of several possible conditions is 
true. If the condition is satisfied, Indirect executes the remainder 
of the command line. 


When comparing a string symbol with a string expression, Indirect 
compares the ASCII values of each operand's characters (from left to 
right) one by one. An operand is considered greater if the first 
nonequal character has a greater value than the corresponding 
character in the other operand. Numeric symbols are compared strictly 
on the basis of magnitude. 


Format: 


-IF symbol relop expr directive-statement 


where: 

symbol The 1- to 6-character numeric or string symbol. 
relop One of the following relational operators: 

EQ or = - Equal to 

NE or <> - Not equal to 

GE or >= - Greater than or equal to 

LE or <= ~ Less than or equal to 

GT or > - Greater than 

LT or < - Less than 
expr An expression of the same type as symbol. 
directive- The Indirect command line to be processed if the 
statement condition is satisfied. 
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Examples: 


»SETS X "A" 
-SETS Y "a" 
~-IF X LT Y .GOTO 200 


The ASCII value of string symbol X is less than the ASCII value of 
string symbol yY, which satisfies the less-than condition. Thus, 
control passes to the line containing the label .200:. 


-SETN Nl 2 
-SETN N2 7 
-IF Nl <= N2 PIP /LI 


With the condition satisfied (numeric symbol Nl less than or equal _ to 
numeric symbol N2), the PIP command is processed. 


-SETS S1 "AAb" 

-SETS S2 "AA" 

-SETS S3 "BBBB" 

-IF Sl >= S2+S3[{1:1] .~INC N 


Since the condition where string symbol Sl is greater than or equal to 
string symbol S2 concatenated with the first character of string 
symbol S3 (AAb >= AAB) is satisfied, Indirect increments numeric 
symbol N. 


4.6.18.2 Test If Task Is Active or Dormant| (.IFACT/.IFNACT) - The 
-IFACT or .IFNACT directive tests whether a taski j sTFACT) or 
dormant (.IFNACT). If the test is true, the rest of the command is 
processed. If the specified task is not installed, Indirect assumes 
the dormant condition. 
Formats: 

-IFACT taskname directive-statement 

-IFNACT taskname directive-statement 
where: 

taskname A 1- to 6- character legal task name. 

directive- The Indirect command line to be processed if the 

Statement condition is satisfied. 


Examples: 
- IFACT REPORT .GOTO 350 


-IFNACT REPORT RUN REPORT 


4.6.18.3 Test If Symbol Is Defined or Not Defined (.IFDF/IFNDF) ~ The 
-IFDF or .IFNDF directive tests whether a logical)numeric, oy”string 
symbol has been defined (.IFDF) or not defined (.IFND the test 
is true, the rest of the command line is processed. This directive 
does not test the value of the symbol. 
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Formats: 
-IFDF ssssss_ directive-statement 


~IFNDF ssssss’7 directive-statement 


where: 
ssssss The 1- to 6-character symbol being tested. The 
symbol can be local, global, or an _ Indirect 
special symbol. 
directive- The Indirect command line to be processed if the 
statement condition is satisfied. 


Examples: 
~IFDF A .GOTO 100 


-IFNDF A  .ASK A DO YOU WANT TO SET TIME 


4.6.18.4 Test If Task Is Installed Or Not Installed (.IFINS/.IFNINS) 
The .IFINS or .IFNINS directive tests whether task is ins 
(.IFINS) or not installed (.IFNINS) in the system. I 
true, the rest of the command line is processed. 


Formats: 
~IFINS taskname directive-statement 


-IFNINS taskname directive-statement 


where: 
taskname A 1l- to 6-character task name. 
directive- The Indirect command line to be processed if the 
statement condition is satisfied. 


Examples: 
-IFINS PIP .GOTO 250 


-IFNINS PIP INS SPIP 


Seager lo ne 
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4.6.18.5 Test If Mode Is Enabled Or Disabled( (.IFENABLED/.IFDISABLED)}-~ 
- The .IFENABLED or .IFDISABLED directive tes ther—an operating 


mode has been enabled with the .ENABLE directive or disabled with the 
-DISABLE directive. (See the description of the .ENABLE directive in 
Section 4.6.12 for the list of operating modes.) 

Formats: 


~IFENABLED option directive-statement 


-IFDISABLED option directive-statement 
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where: 
option The same operating mode option (with the exception 
of DATA) used with the .ENABLE or .DISABLE 
directive, or FULL-DUPLEX, POTASK, or FMS. (FMS 
is valid only on RSX-11M-PLUS systems.) 
directive- The Indirect command line to be processed if the 
statement condition is satisfied. 


4.6.18.6 Test If Driver Is Loaded Or Not Loaded ((.IFLOA/.IFNLOA) - 


The .IFLOA or .IFNLOA directive tests whether a driver is..loaded 
(.IFLOA) or not loaded (.IFNLOA) in the system. If the test is true, 
the rest of the command line is processed. Note that for purposes of 
this directive, resident drivers are assumed to be loaded. 
Formats: 

~IFLOA dd: directive-statement 


e-IFNLOA dd: directive-statement 


where: 
dd: A device driver 
directive- The Indirect command line to be processed if the 
statement condition is satisfied. 


Examples: 
-IFLOA DK: .GOTO 250 


-IFNLOA DK: LOA DK: 


nae 7 ) Mais 
4.6.18.7 Test If Symbol Is True Or False ( (.IFT/.IFF)/- The .IFT or 
-IFF directive tests whether a logical bol is true or false. If 
the test is true, Indirect processes the remainder of the command 


line. 


Indirect exits with a fatal error if the symbol being tested was 
previously defined as a numeric or string symbol. 


Formats: 
-IFT ssssss directive-statement 


-IFF ssssss_ directive~statement 


where: 
ssssss The 1l- to 6-character logical symbol being tested. 
directive- The Indirect command line to be processed if the 
statement condition is satisfied. 


Examples: 


Tum 
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-IFF B .GOTO 200 
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4.6.18.8 Compound Tests - You can combine .IF tests by using the .AND 
and .OR directives. In addition, an implied .AND is effected when 
more than one .IF appears on the same line without being separated by 
an .AND directive. 


The .AND directive takes precedence over the .OR directive as shown in 
the following example: 


-IFT A .OR .IFT B .AND .IFT C .GOTO D 
That is, Indirect reads the line as: 

-IFT A .OR (.IFT B .AND .IFT C) .GOTO D 
Examples: 

-IFT A .AND .IFF B- .GOTO HELP 


If the logical symbol A is true and the logical symbol B is false, 
control passes to the line containing the label .HELP:. 


-lFT A .IFF B -GOTO HELP 
Same effect as the previous directive (.AND implied). 
~IFT A .OR .~IFF B RUN PIP 


If the logical symbol A is true or if the logical symbol B is false, 
the RUN command is issued. 


-6.19 Increment Numeric Symbol f ,INC . 
g 


The .INC directive increments a numeric symbol by one. Indirect j 
with a fatal error if the symbol was previously defined as a logical 
or string symbol. 
Format: 

- INC ssssss 
where: 

ssssss The 1l- to 6-character numeric symbol being incremented. 
Example: 


-INC B 


Increment by 1 the value assigned to the numeric symbol RB. 


4.6.20 Define Logical End-of-File / 


The logical end-of-file directive (/) terminates file processing and 
exits. The message 


>@ <EOF> 


is then displayed (if display mode has not been disabled). 
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Format: 
if 


as the first nonblank character on a line. 

You can use this directive at any location in the command file _ to 
quickly terminate file processing, but care should be taken to avoid 
an inadvertent exit. 


Example: 


-ASK CONT DO YOU WISH TO CONTINUE 
-IFT CONT .GOTO 100 


-100: 


Oa 
4.6.21 Branch to Label on Detecting an Error " ,ONERR 


If Indirect detects one of the following errors: SN a4 


e Task not installed in system (.XOT, .WAIT) 

e Undefined symbol 

e Bad syntax (.XQT, .WAIT, .DELAY) 

e Unrecognized command 

e String substitution error 

e Symbol type error {.IF, .IFT, .IFF, .~INC, .DEC) 


e Redefinition of a symbol to a different type (.ASK, .ASKN, 
sASKS; «SETT,. «<SETE, .SETL, «SETN, «SETD,. +SETO, «SETS) 


e Data file error (.OPEN, .OPENA, .OPENR, .DATA, .CLOSE, or 
-READ between .ENABLE DATA and .DISABLE DATA) 


control passes to the line containing the specified label. This 
feature provides you with a means of gaining control to terminate 
command file processing in an orderly manner. 


Note that the .ONERR directive applies only to the error conditions 
listed; errors returned from a task external to Indirect (for 
example, an MCR syntax error) are not processed by the .ONERR 
directive. 


Format: 
-ONERR- label 


Upon detecting an error, the processor passes control to the line 
starting with .label:. The .ONERR directive must be issued before 
Indirect encounters the error condition. If the directive is executed 
(one of the listed errors is encountered), error processing passes to 
the specified label. If the label specified by the .ONERR directive 
does not exist and an error condition has occurred, command processing 
terminates. 
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Once an .ONERR condition has occurred, another .ONERR directive must 
be issued to trap a future error. 


The .ONERR directive works with the special symbol <ERRCTL> (see 
Section 4.4.1.2). For each class of error that an .ONERR target 
routine processes, the appropriate bit is set in the symbol. The 
initial default value for <ERRCTL> is 1, which implies that only class 
1 errors can be handled with an .ONERR routine. (Note that if you 
attempt to process errors other than default class 1, Indirect cannot 
continue in most cases. The error service routine is limited to a 
fatal error message and .EXIT. The internal state of Indirect is 
indeterminate in all but class 1 error cases.) See Section 4.8 for a 
list of error messages and their assigned class values. 


Example: 
-ONERR - 100 


Upon detecting one of the error conditions, Indirect passes control to 
the line labeled .100:. 


4.6.22 Open Secondary File 


The .OPEN directive opens a specified secondary file as an output 
file. The .DATA directive is used to place data in this secondary 
file. 


Format (brackets not part of syntax): 
-OPEN [#n] filename 
where: 


filename A file to be opened as an output file. The default 
file type is .DAT. 


#n An optional file number in the range 0 to x-l, where x 
is the number of file-open FDBS specified in the build 
file for the Indirect task. (x is the maximum number 
of files that can be open simultaneously.) The default 
is #0. You can substitute a numeric symbol for the 
value n by enclosing the symbol in apostrophes. 


Note that you cannot include a comment that begins with a _ semicolon 
(;CcComment) in an .OPEN statement. Doing so results in a syntax error. 
(Comments that begin with an exclamation mark (!comment) are 
accepted.) 


Example: 
-OPEN SECOUT 
This directive opens the file SECOUT.DAT as an output file. 


4.6.23 Open Secondary File for Append [ .OPENA 
The .OPENA directive opens a secondary file and appends all ameegaane 
data to the file. 
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Format (brackets not part of syntax): 
~OPENA [#n] filename 
where: 


filename A Secondary file to be opened with subsequent data 
appended to it. The default file type is .DAT. 
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#n An optional file number in the range 0 to x-l, where x 
is the number of file-open FDBs specified in the build 
file for the Indirect task. (x is the maximum number 
of files that can be open for append simultaneously.) 
The default is #0. You can substitute a numeric symbol 
for the value n by enclosing the symbol in apostrophes. 


Note that you cannot include a comment that begins with a _ semicolon 
(;comment) in an .OPENA statement. Doing so results in a syntax 
error. (Comments that begin with an exclamation mark (!comment) are 
accepted.) 


If the specified file does not already exist, .OPENA becomes the .OPEN 
directive by default. . 


Example: 
-~OPENA SECOUT 


This directive opens the file SECOUT.DAT as an output file and appends 
subsequent data to it. 


ao 


4.6.24 Open File for Reading ( -OPENR / 


The .OPENR directive opens a file for reading with the. RBAD 
directive. 


Format (brackets not part of syntax): 
-OPENR [#n] filename 


where: 


filename A file to be opened for reading. The default file type 
is .DAT. 


#n An optional file number in the range 0 to x-1l, where x 
is the number of file-open FDBs specified in the build 
file for the Indirect task. (x is the maximum number 
of files that can be open for reading simultaneously.) 
The default is #0. You can substitute a numeric symbol 
for the value n by enclosing the symbol in apostrophes. 


Note that you cannot include a comment that begins with a _ semicolon 
(;comment) in an .OPENR statement. Doing so results in a syntax 
error. (Comments that begin with an exclamation mark (!comment) are 
accepted.) 
Examples: 


-OPENR INDADD 
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This directive opens the file INDADD.DAT for reading with the .READ 
directive. 


-OPENR DATLIB.ULB/LB: DATINP 


This directive opens for reading the library module DATINP that is 
contained in the universal library DATLIB. 


4.6.25 Parse Strings into Substrings / ~PARSE } 
The .PARSE directive parses strings in a command line into Le 
Format: 


-PARSE <string> <control-string> <varl> <var2> ... <varn> 


The string is broken up into substrings as specified by the control 
string. The substrings are stored in the specified variables. The 
first character of the control string delimits the first substring, 
the second character of the control string delimits the second 
substring, and so on. The last character of the control string is 
repeated if the number of variables exceeds the length of the control 
String. If you specify more variables than substrings, the additional 
variables are set to null strings. If you specify less variables than 
the number of substrings that can be parsed, the last variable 
contains the unparsed fragment of <string>. 


The symbol <STRLEN> contains the actual number of substrings that 
Indirect processed (including explicit null substrings). 


Example: 


-PARSE COMMAN " ," FILE Al A2 A3 A4 A5 


Given that COMMAN contains "TESTFILE IND,MCR,,LOA", this directive has 
the following results: 


FILE = TESTFILE 
Al = IND 
A2 = MCR 
A3 = null 
Ad = LOA 
A5 = null 


<STRLEN> contains a 5. 


ie ——~, 


4.6.26 Pause for Operator Action ( ae 


oy 


The .~PAUSE directive interrupts processing of an indirect commana—£ite 
to wait for user action. A .PAUSE directive causes Indirect to stop 
itself. You can then perform some Operations and subsequently cause 
the task to resume. 
Format: 

- PAUSE 


When Indirect stops itself, it displays the following message on _ the 
entering terminal: 


AT. -- PAUSING. TO CONTINUE TYPE "command taskname" 
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where: 
command The command line to be issued to resume the task. 
taskname The name of the Indirect task. 


You then type the appropriate command line to resume the task. 
Indirect then displays the message: 


AT. -- CONTINUING 
and it continues processing where it left off. 


Note that the .PAUSE directive is legal only if the command line 
interpreter for your terminal is MCR or DCL. 


4.6.27 Read Next Record ( a 


The .READ directive reads the next record into a specified string 
variable. The entire record is written into the variable. If the 
record is longer than 132(10) characters, an error occurs. 


After every .READ operation, the special symbol <FILERR> contains’ the 
FCS-11 file code for the read and the special symbol <EOF> reflects 
whether an end-of-file was found. (Ndédte that .OPENR does not clear 
<EOF>.) If an error or end-of-file occurs, the string variable remains 
unchanged from its previous state. 


Format (brackets not part of syntax): 


-READ [#n] ssssss 


where: 

#n An optional file number that specifies the file from 
which the record is to be read. The file number must 
be one of the numbers used in a previous .OPENR 
statement. 

ssssss The string variable into which the record will be read. 

Example: 
- ENABLE SUBSTITUTION 
-OPENR FILE 
IF <FILERR> NE 1 .GOTO ERROR 
- LOOP: 
- READ RECORD 
~-IFT <EOF> .GOTO DONE 
-IF <FILERR> NE 1 .GOTO ERROR 
; "RECORD' 
-GOTO LOOP 
- ERROR: . 
- DONE: - CLOSE 
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These directives open the file FILE.DAT for reading, read each record 
into the string variable RECORD, display each record on the terminal, 


and close the file. 


4.6.28 Return from a Subroutine \ »RETURN // 


Penal 
The .RETURN directive signifies the end of a subroutine and _ returns 
control to the line immediately following the .GOSUB directive that 
initiated the subroutine. 


Format: 


- RETURN 


4.6.29 Set Symbol to True or False ~SETT/ .SETF/.SETL 


The .SETT, .SETF, and .SETL directives define or change the value of a 
specified logical symbol. Tf the symbol has not been defined, 
Indirect makes an entry in the symbol table and sets the logical 
symbol to the value specified. If the symbol has already been 
defined, Indirect resets the symbol accordingly. Indirect exits with 
a fatal error if the logical symbol was defined previously as a 
numeric or string symbol. 


Formats: 
-SETT ssssss 
-SETF ssssss 


-SETL ssssss 111111 


where: 
ssssss The 1- to 6-character logical symbol to be assigned a 
true or false value. 
ee ee A logical or numeric expression. ssssss is assigned 


the value of 111111 when the logical expression is 
evaluated. 


Examples: 
-SETT X 
This directive sets the logical symbol X to true. 


-SETF ABCDE 


This directive sets the logical symbol ABCDE to false. 


-SETL TEST SWITCHA! SWITCHB 


This directive sets the logical symbol TEST to true if SWITCHA or 
SWITCHB is true. 
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4.6.30 Set Symbol to Numeric Value - SETN 


The .SETN directive defines or changes the value of a _ specified 
numeric symbol. If the symbol has not been defined, Indirect makes an 
entry in the symbol table and sets the symbol to the numeric value 
specified. If the symbol has already been defined, Indirect resets 
the symbol accordingly. Indirect exits with a fatal error if the 
numeric symbol was previously defined as a logical or string symbol. 


Format: 


-SETN ssssss numexp 


where; 
ssssss The l1- to 6-character numeric symbol. 
numexp A numeric expression. (See Section 4.4.2.) 


When specifying a numeric value to assign to a symbol, you may combine 
a numeric symbol or constant with another numeric symbol or constant 
to form a numeric expression. If numeric expressions are used, no 
embedded blanks or tabs are permitted. Evaluation is done from left 
to right unless parentheses are used to form subexpressions that are 
evaluated first. The radix of an expression is octal if all the 
operands are octal and decimal mode has not been enabled; otherwise 
the radix is decimal. 


Examples: 
-SETN NUMBER 27 

This directive assigns to the numeric symbol NUMBER the value 27(8). 
~SETN Al 3*(A2-5) 


This directive assigns the numeric symbol Al the value of symbol A2 
minus 5 multiplied by 3. 


4.6.31 Set Symbol to Octal or Decimal ~SETO/.SETD 
The .SETO and .SETD directives redefine the radix of a 
numeric symbol. If the symbol has not been defined, Indirect makes an 
entry in the symbol table and sets the symbol to the specified radix 
with a value of 0. If the symbol has already been defined, Indirect 
resets the symbol accordingly. Indirect exits with a fatal error if 
the symbol was previously defined as a logical or string symbol. 


Formats: 
-~SETO ssssss 
-SETD ssssss 


where: 


ssssss The 1- to 6-character numeric symbol to be assigned an 
octal or decimal radix. 
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Example: 
-SETN A 10 ; Sets symbol A to 10(8) 
-SETD A ; Defines A as a decimal radix symbol with a value 
of 8(10). 
-SETO A ; Defines A back to original radix with a value of 


10(8). 


4.6.32 Set Symbol to String value SETS , 


af 
The .SETS directive defines or changes the string value of a spe 
string symbol. If the symbol has not been defined, Indirect makes an 
entry in the symbol table and sets the symbol to the specified string 
value. If the symbol has been defined, Indirect resets the symbol 
accordingly. Indirect exits with a fatal error if the symbol was 
defined previously as a logical or numeric symbol. 


Format: 


-SETS ssssss strexp 


where: 
ssssss The 1- to 6-character string symbol. 
strexp Any string expression. (See Section 4.4.3.) 


Indirect assigns to the specified symbol the string value represented 
by the string expression strexp. If a string constant is used in 
Sstrexp, the constant must be enclosed by quotation marks ("constant"). 


You can combine a string symbol, constant, or substring with another 
String symbol or substring by the string concatenation operator (+) to 
form a string expression. 
Examples: 
-SETS A "ABCDEF" 
This directive assigns to the string symbol A the string value ABCDEF. 
SETS STR2 "ZZZ" 


This directive assigns string symbol STR2 the value 222. 


-SETS X STR2+"ABC" 


This directive assigns string symbol xX the value of symbol STR2 plus 
ABC (that is 2ZZABC). 


-SETS X STR2+A[1:3] 


This directive is equivalent to the previous directive; it assigns 
the string symbol xX the string value of STR2 plus the first three 
characters of string A (that is ZZZABC). 


~-SETS MYFILE <UIC>+"MYFILE. TXT" 


This directive assigns the string symbol MYFILE the string value of 
the current UIC and the string contained within the quotation marks 
(for example, if the current UIC is [303,3], MYFILE is assigned the 


string value [303,3]MYFILE.TXT). 
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4.6.33 Terminate Command File Processing ey, 
hale 


The .STOP directive immediately terminates command file processing and 
exits. The message 


>@ <EOF> 
is then displayed (unless .DISABLE DISPLAY is in effect). 


The .STOP directive allows you to optionally set the exit status for 
Indirect execution. 


Format (brackets not part of syntax): 


~-STOP [value] 


where: 
value An optional numeric expression to serve as the exit 
status for Indirect. If you do not specify an exit 
statts value, the .STOP directive is identical to the 
logical end-of-file directive (/). 
Example: 
~-STOP 0 


This directive terminates command file processing and sets the exit 
Status for Indirect to 0. 


ears ie 
4.6.34 Test Symbol “TEST 
The .TEST directive has two different functions. It tests a variable —- 
and sets various special symbols accordingly, and it does substring 
searches and sets the special symbol <STRLEN> accordingly. 
Format 1: 
TEST ssssss 
where: 
sssss The l- to 6-character symbol to be tested. 
The results of the test are as follows: 
e If variable is a string, <SYMTYP> is set to 4 and 
<STRLEN> contains the length of the string. Also, 
the special symbols <ALPHAN>, <NUMBER>, <RAD50>, and 
<OCTAL> are set based on a scan of the characters of 
variable. 


e If variable is numeric, <SYMTYP> is set to 2. 


e If variable is octal, <SYMTYP> is set to 2 and 
<OCTAL> iS set to TRUE. 


e If variable is logical, <SYMTYP> is set to 0. 
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Format 2: 
-TEST string substring 
where: 
string A string symbol or constant. 
substring A string expression. 
In this case, the substring is searched for in the specified 
string. If the substring is present, <STRLEN> is set to the 
position of the starting character of the substring within 
the string. If substring is not present, <STRLEN> is set to 
0. 
Examples: 
1. I£ SUM is a string symbol, the directive statement 
-TEST SUM 


sets <SYMTYP> to 4 and places the number of characters 
represented by the symbol SUM into <STRLEN>. 


2. The directive statements 


-SETS MAIN "ABCDEF" 
-TEST MAIN "C" 


set <STRLEN> to 3, the position of C in the string ABCDEF. 


4.6.35 Test Device \ - TESTDEVICE 


The .TESTDEVICE directive allows a command file to acquire™information 
about any device in the system. The information, including error 
indications, is contained in the string symbol <EXSTRI>. Each device 
attribute in the string is separated by a comma (which allows 
processing by the .PARSE and .TEST directives). The first field of 
the string is the full physical name of the device. The next four 
fields are octal representations of the device-characteristics words 
(U.CWl through U.CW4 of the Unit Control Block). Additional fields 
contain more information about the device. 


Format: 
-TESTDEVICE dd[nn]: 
where: 


dd{nnj]: The device about which the command file is requesting 
information. 


The information stored in <EXSTRI> is in the following form: 
ddnn:,xxX,XX,;XX,x¥X,atr,atr...,atr; 
where: 


ddnn: The physical device name for the device specified in 
the command line. 


‘ 
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XX,XX,_ The four device-characteristics words in octal 
XX ,XX notation. (See the RSX-11M or RSX-11M-PLUS Guide to 
Writing an I/O Driver for more information.) 


atr One or more of the following device attributes: 


NSD "No such device" is configured into this system. 

LOD The device driver is loaded. 

UNL The device driver is not loaded. 

ONL The device is on-line. 

OFL The device is off-line. 

MTD The device is a mountable volume and is mounted. 

NMT The device is not a mountable volume or is not 
mounted. 

FOR The device is a mountable volume and is mounted 
foreign. 

NFO The device is not a mountable volume or is not 
mounted foreign. 

PUB The device is a public device. 

NPU The device is not a public device. 

ATT The device is attached to another task. 

ATU The device is attached to this copy of Indirect. 

NAT The device is not attached. 

ALO The device is allocated to another terminal. 

ALU The device is allocated to this terminal. 

NAL The device is not allocated. 


<EXSTRI> contains the value "NSD," (no such device) if the device is 
not present in the current system configuration. 


Example: 
-TESTDEVICE SY: 


This directive acquires information about user logical device SY: and 
stores it in <EXSTRI>. 


4.6.36 Test a File -TESTFILE 


The .TESTFILE directive determines if a specified file exists or it 
determines the physical device associated with a logical name (that 
is, performs device translation). 

If you specify a file in the command line, the results of a .TESTFILE 
operation are contained in the symbols <FILSPC> and <FILERR>. 
<FILSPC> contains the fully qualified file specification and <FILERR> 
contains the FCS status code resulting from the search for the file. 


If you do not specify a file in the command line, Indirect only 
performs device translation. 


Formats: 
-TESTFILE filespec 
»TESTFILE 11: 
where: 


filespec The file to be tested. 
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li: The logical name assigned to be translated to a 
physical device. 
Examples: 
e-TESTFILE MP: IND.MAP 
This directive assigns the following values if the file exists: 


<FILERR> 
<FILSPC> 


i 
DR1:[{101,300]IND.MAP;4 (MP: is the logical name 
assigned to the physical device DR1:.) 


If the file does not exist, the directive assigns the following 
values: 


<FILERR> = 346 (230 decimal) 
<FILSPC> = DR1: [101,300] IND.MAP;0 
The following directive translates the logical name TI: into its 


physical device name. 
e-TESTFILE TI: 


The directive assigns the symbol values as follows: 


<FILERR> = 1 
<FILSPC> = TT23:.DAT;0 eS 
4.6.37 Test a Partition | TESTPARTITION 


The .TESTPARTITION directive allows a command ee ee 
information about a partition in the system. The partition can be the 
one in which Indirect is running or any other partition. You can use 
the directive to verify that a partition is large enough before 
installing a task in it or that the partition is present before 
loading a special system. Indirect returns the information (in the 
special symbol <EXSTRI>) in the following format: 


partition-name,base,size,type, 
where base and size are in 64-byte blocks and type is SYS for 
system-controlled partitions, USR for user-controlled partitions, or 
NSP for an unknown partition name. If the partition is not found, 
Indirect returns a "No Such Partition" error in the form: 
partition-name,,,NSP, 
Format: 
-TESTPARTITION partition-name 
where: 
partition- A l- to 6-character legal partition name. If you use 
name the wildcard (*) instead of a partition name, 
Indirect assumes you are testing the same partition 
in which the current version of Indirect is 
executing. 
Example: 
-TESTPARTITION GEN 
;GEN,1500,2303,SYS, 
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This directive obtains information about the partition named GEN. The 
partition has a starting address of 150000(8), it is 230300(8) bytes 
lon 


ong, and it is a system-controlled partition. 


4.6.38 Wait for a Task to Finish Execution & 


The .WAIT directive suspends processing of an indirect command 
until a particular task has terminated. 


Format: 
-WAIT taskname 
where: 
taskname A 1- to 6-character legal task name. 


If the task name is omitted, Indirect assumes the task name applied by 
the last "RUN task" command. This name is specified as 


TTnn 

where: 
rT The invoking terminal. 
nn The terminal number. 


The .WAIT directive also sets the symbol <EXSTAT> with the exit status 
of the completed task. 


If the specified (or default) task is not installed, Indirect ignores 
the .WAIT directive. The .WAIT directive performs no function if the 
/NOCLI or /NOMC switch is in effect. 

Example: 


-WAIT PIP 


This directive discontinues processing of the command file until the 
terminal-initiated task PIP exits. 


4.6.39 Initiate Parallel Task Execution -XQT 
Indirect usually passes a command to the CLI and waits until e 
command's execution has completed. However, it is possible for 


Indirect to initiate a task and not wait for it to complete before 
executing the next directive. The .XQT directive allows you to start 
a task, to pass a command line to it, and to continue processing in 
parallel with the initiated task. (In MCR, you can also use the RUN 
/CMD="command-line" command to pass command lines to another task.) 
The maximum number of successive .XQT directives allowed depends on 
the parameter specified in the build file for the Indirect task. 
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Format: 
-XQOT taskname command-line 

where: 
taskname The name of the task (for example, MAC, PIP, DMO). 
command-line The command line to be executed. 


The .XQT directive allows you to initiate parallel processing of 
tasks. The .WAIT directive can be used to synchronize their 
execution. 


Example: 


-XOQT MAC TEST, TEST=TEST 
-XQOT TKB BLD,BLD=BLD 
~-WAIT MAC 

-WAIT TKB 


The example starts an assembly and a task build executing in parallel 
and then waits for the two tasks to complete. 


4.7 EXAMPLES 


e Invoking Indirect interactively and displaying symbols: 


>@TI: 
AT.> 


Specifying @TI: allows you to work with Indirect 
interactively. When Indirect issues the AT.> prompt, you can 
enter directive statements, invoke command files, or display 
the values of special symbols. To display a symbol, use the 
-ENABLE SUBSTITUTION directive, then request the symbol in the 
following format: 


AT.>;'<symbol>' 
e Using an indirect command file: 


A file named ASSEMBLY.CMD contains the following command 
lines: 


- ENABLE SUBSTITUTION 
¢.<TIME>* 


MAC @MACASM.CMD 
- EXIT 


To execute the command file, use the following command line: 


MCR> @ASSEMBLY 
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4.8 INDIRECT MESSAGES 

When Indirect encounters an error, it prints the appropr 
message and the command line in which the err 

contained a substitution, the line as i 
substitution took place is also displayed. 


c 


Section 4.8.1 explains the information-only messages and Section 4.8.2 
explains the error messages. The error messages are divided into 
classes, depending on the level of severity. Class 2 errors can be 
handled with the <ERRCTL> symbol (see Section 4.4) and class 1 errors 
can be handled with the .ONERR directive (see Section 4.6.21). Class 
0 errors must be corrected outside of Indirect. 


4.8.1 Information-only Messages 


@ <EOF> 


(Class 0) Indirect has reached the end-of-file for the 
outermost command file and is terminating execution. 


ATs. = CONTINUING 


Indirect is resuming execution after a .PAUSE or .DELAY 
directive. 


Pile, Ser DELAYING 


A .DELAY directive was just executed, halting the processing 
of an indirect command file for a specified period of time. 


AT. == INVALID ANSWER OR TERMINATOR 


In response to a question from .ASK, you entered something 
other than Y, N, or null, followed by a RETURN; or you did 
not enter a numeric value in response to an .ASKN question; 
or you pressed the ESCAPE key either without escape 
recognition enabled or as a character other than the first 
one following the question. The question will be repeated. 


AT. -- PAUSING. TO CONTINUE TYPE “command taskname" 
Indirect just executed a .PAUSE directive, interrupting 


processing of an indirect command file to wait for user 
action. 


AT. == VALUE NOT IN RANGE 


The response to an .ASKN or .ASKS question was not within 
the specified range. Indirect repeats the question. 


4.8.2 


AT. 


AT. 


AT. 


AT. 


AY 


AT. 


AT. 


AT. 


AT. 
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Error Messages 


BAD RANGE OR DEFAULT SPECIFICATION 

(Class 1) An illegal character was specified as a range or 
default argument. Only numeric expressions are permitted. 
COMMAND FILE OPEN ERROR 


(Class 2) The file being invoked in an @file or 
@file/LB:module command line cannot be found or opened. 


DATA FILE ERROR, CODE x. 


(Class 1) Indirect encountered an error while processing an 
-OPEN, .OPENA, .CLOSE, or .DATA directive or a data mode 
access to the secondary file. See the IAS/RSX-11 I/0 


Operations Reference Manual for a definition of the numeric 


code x. 


FILE ALREADY OPEN 


(Class 1) An .OPEN or .OPENA directive specified a file that 
was already open. 


FILE NOT FOUND 

(Class 2) An @filename or .CHAIN directive specified an 
incorrect file name or nonexistent file. 

FILE NOT OPEN 


(Class 1) Indirect encountered a .DATA or .CLOSE directive 
that did not reference an open file. 


FILE READ ERROR 

(Class 2) An error was detected in reading the indirect 
command file. This error is usually caused by records that 
are more than 132(10) bytes long. 

ILLEGAL FILE NUMBER 

(Class 1) The file number in an .OPEN, .OPENA, .OPENR, 
-DATA, -ENABLE DATA, .READ, or .CLOSE directive is not in 
the range of 0O through 3. 

ILLEGAL NESTING 

(Class 1) Too many Begin-End blocks have been nested in the 


indirect command file. The maximum nesting depth is limited 
to the size of the symbol table. 


AT. 


AT. 


AT. 
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INITIALIZATION ERROR, CODE x. 

(Class 0) Indirect failed to complete initialization when 
you invoked it. The following list gives the meaning of the 
displayed code number: 


1. Unable to acquire system information such as_ the 
UIC or device name 


2. Impure area setup failed 
3. Unable to acquire task-specific information 
4, Unable to acquire terminal-type information 


5. Unable to acquire the disk name and other 
information about the system device (SY:) 


6. Unable to allocate enough space for command and 
data I/0 buffers. For privileged Indirect tasks, 
Indirect was not installed with a large enough 
increment value. The system manager should remove 
and reinstall Indirect with a larger increment or 
in a larger partition. For the nonprivileged 
Indirect task, the EXTEND TASK directive failed to 
return sufficient space for Indirect to allocate 
the buffers. 


7. Initialization of allocated buffers failed 
8. Initialization of the DATA file structures failed 


9. Allocation of FCS-11 buffers for data and command 
lines failed 


10. Symbol table initialization failed 
ll. Initialization cleanup failed 
12. Unable to obtain initial command line 


>12. Error codes greater than 12 are returned by FMS-11 
and other special purpose initialization modules 


Error number 6 is the only initialization error that you 
should encounter. If any other error from 1 through 12 
persists, submit a Software Performance Report (SPR) with 
any other pertinent information. 

INVALID KEYWORD 

(Class 1) An unrecognized keyword (preceded by a period) was 
specified. 


LABEL NOT AT BEGINNING OF LINE 


(Class 1) The specified label does not start in the first 
column of the line. All labels must do so. 


AT. 


AT. 


AT. 


AT. 


AT. 


AT. 


AT. 


AT. 


AT. 
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MAXIMUM INDIRECT FILE DEPTH EXCEEDED 

(Class 2) An attempt was made to reference an indirect 
command file at a nested depth greater than the maximum 
specified in the build file for the Indirect task. 

NO POOL SPACE 

(Class 2) The dynamic memory allocation has been exhausted. 
Either wait for more pool space to become available or use 
the MCR SET /POOL command. 

NULL CONTROL STRING 

(Class 1) The control string specified with the .PARSE 
directive was null (there were no characters between the 
quotation marks). 

NUMERIC UNDER- OR OVERFLOW 

(Class 2) The evaluation of a numeric expression yielded a 
value outside the range 0 through 177777(8). 

REDEFINING A READ-ONLY SYMBOL 

(Class 2) An attempt was made to assign a new value to a 
read-only symbol. Read-only symbols cannot be overwritten. 
REDEFINING SYMBOL TO DIFFERENT TYPE ssssss 

(Class 1) An .ASK, .ASKN, .ASKS, .READ, .SETT, .SETF, .SETL, 
-SETN, or .SETS directive was used in an attempt to set the 
specified, already defined symbol to a different type. The 
first definition of a symbol determines its type (logical, 
numeric, or string); subsequent value assignments must 
conform to the original type. 

-RETURN WITHOUT .GOSUB 

(Class 1) A  .RETURN directive was specified without a 
previous call to a subroutine (.GOSUB). 

SPAWN FAILURE 

(Class 1) Indirect could not initiate the execution of a 
user command task. 


STRING EXPRESSION LARGER THAN 132. BYTES 


(Class 2) An at 
x 


empt was made to generate a string 
expression longe ( 


t 
than 132(10) characters. 
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STRING SUBSTITUTION ERROR 


AMMAN eA YeAA an arvrar Air 


(Class a) Indirect encountered an error GUE ing a 
substitution operation. A probable cause for the error is 
either the omission of a _ second apostrophe or the 


specification of a symbol that is not defined. 


SUBROUTINE NESTING TOO DEEP 
(Class 1) The maximum subroutine nesting level was exceeded. 


The maximum level is specified in the build file for the 
Indirect task. 


SYMBOL TABLE OVERFLOW ssssss 


(Class 2) The symbol table was full and there waS no_- space 
for symbol ssssss. 


SYMBOL TYPE ERROR ssSssss 
(Class 1) The symbol ssssss was used out of context for its 
type; for example, a numeric expression referenced a 


logical symbol. Only symbols of the same type can be 
compared. 


SYNTAX ERROR 


(Class 2) The format of the specified command line is 
incorrect. 


TOO MANY CONCURRENT .XQTS 
(Class 1) More than the maximum number of successive .xXQT 


directives allowed by the build file for the Indirect task 
were issued. 


UNDEFINED LABEL .label: 


(Class 1) The label .label: specified in a .GOTO, .GOSUB, 
or .ONERR directive could not be found. 


UNDEFINED SYMBOL sSSSSSS 


(Class 1) The symbol ssssss was referenced, but it had not 
been defined. 


APPENDIX A 


MCR AND TKTN MESSAGES 


Messages from MCR and TKTN appear in this appendix in alphabetical 
order. Some messages include remedial action to be taken by the user. 
This is not included with messages for which the required action is 
obvious or contained in the description of the message. 


The XXX in the messages indicates the 3-character component of MCR 
that detected the error. 


11/40 F.P. exception 
Explanation: This is a TKTN message. The task encountered a 
floating point exception while executing on a PDP-11/40 and no 
SST routine was specified to process the trap. 


Aborted via directive or CLI 
Explanation: This is a TKTN message. Either an Executive 
directive or a CLI command issued by another task caused the task 
to be aborted. 


Aborted via CLI 


Explanation: This is a TKTN message. A CLI command aborted the 
task. 


XXX -- Account file open failure 


Explanation: The account file was open for another user or _ the 
disk containing the account file was not mounted. 


User Action: Reenter the command line. 


MCR AND TKTN MESSAGES 


XXX -- Addressing extensions not supported 
Explanation: The command tried to install a task with a VSECT 
(virtual section) into a system that does not support the 
feature. 


XXX -- Alignment error 


Explanation: An attempt was made to create a partition, but’ the 
base address or size conflicted with existing partitions or 
physical memory size. 


XXX -- Allocation for SYS file exceeds volume limit 
Explanation: The system was unable to allocate the system file 
from the specified block because intermediate bad blocks or 
end-of-volume was encountered. 


XXX -- Ambiguous help qualifier 


Explanation: The qualifier does not specify a unique part of the 
help file. 


User Action: Reenter the command line, specifying the qualifier 
more completely. 


XXX -- Ambiguous help synonym 
Explanation: The qualifier referenced aS a synonym was not 
unique. 

XXX -- Assign failure 


Explanation: The HELLO command could not complete login logical 
assignments. 


AST abort. Bad stack 
Explanation: This is a TKTN message. An AST cannot be effected 
because the AST parameters cannot be pushed onto the task's 
stack. 
XXX -- Bad block file corrupt - data ignored 
Explanation: The bad block file contained bad data. 
XXX -- Bad block file full | 
Explanation: The disk had more than 102(10) bad regions on it. 
XXX -- Bad block header I/O error 


Explanation: A write error was detected in writing the bad-block 
file header. 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 
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-- Bad task file VBN, task removed - <taskname> 

Explanation: The system removed the specified task because it 
contained a bad Virtual Block Number (VBN) in its file header. 
The task image file has probably been corrupted. 


-- Base address must be on 4K boundary 


Explanation: The base virtual address of the task is not on a 4k 
boundary. This message applies only to mapped systems. 


-- Base mismatch common block <commonname> 

Explanation: The base address of the partition, as recorded in 
the task image, did not match the base address of the common 
block. 


-- Block(s) exceed volume limit 


Explanation: The specified block (or blocks) exceeded the 
physical size of the volume. 


-~- Boot block write error 


Explanation: An error was detected in writing the volume boot 
block. 


-- Booted device's driver not loaded — 


Explanation: VMR has been used to unload the driver for the 
system (booted) disk. 


-- Booted device not in system -- <dd nnn mmmmmm> 


Explanation: When the system was booted, SAVE could not find the 
booted device (device name dd, physical unit number nnn, CSR 
mmmmmm) in the system data structures. For example, the system 
was booted from DB3:, but the system data structures include only 
DBO: and DBl:. 


-- Byte address 


Explanation: The address specified as the argument to the OPEN 
command waS an odd address. For example, the address 3000 is a 
legal address, but the address 3001 is not. 


-- Cannot install privileged task from non-privileged terminal 


Explanation: This message applies to multiuser protection 
systems only. A nonprivileged user attempted to install a 
privileged task. Only a privileged user can install a privileged 
task. 
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XXX -- Cannot LOAD/UNLOAD a pseudo device 


Explanation: The device you attempted to load is a _ pseudo 
device. You must specify the name of a physical device. 


XXX -- Can't read MCR command buffer 


Explanation: The UFD was initiated by a RUN command rather’ than 
as an MCR command. 


XXX -- Checkpoint area too small 


Explanation: The area allocated for checkpointing the task was 
smaller than the partition into which the task was being 
installed. This message applies only to systems that do not 
Support the dynamic allocation of checkpoint space. 


Checkpoint failure. Read error 


Explanation: This is a TKTN message. The task could not be read 
back into memory after being checkpointed. 


XXX -- Checkpoint file already in use on device 


Explanation: A previous ACS command established a checkpoint 
file on the volume mounted on the specified device unit. A 
volume can contain only one checkpoint file. 


XXX -- Checkpoint file header I/O error 


Explanation: An error was detected in writing the checkpoint 
file header. 


XXX -- Checkpoint file now inactive 


Explanation: This message appears after an ACS command has’' been 
issued to discontinue a checkpoint file and the file does not 
contain any checkpointed tasks. The message indicates that use 
of the file was discontinued immediately after the command was 
issued. If the file is still in use, TKTN will issue a message 
when the file is finally discontinued. 


**k*k <ddnn:> -- Checkpoint file now inactive 


Explanation: This is a TKTN message. A request to discontinue 
use of a checkpoint file on device ddnn: has been satisfied. 
The need to return checkpointed tasks from the discontinued file 
back into memory caused the delay between the request and this 

message. . 


XXX -- Checkpoint file still active 


Explanation: The command attempted to dismount a volume that 
contained an active checkpoint file. The volume cannot be 
dismounted until the checkpoint file has been discontinued. 


User Action: Issue an ACS command to discontinue the file and 
reissue the DMO command when the system issues a message to 
indicate that the checkpoint file is inactive. 
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-- Checkpoint file still in use on <ddnn:> 


= ee ee 


not he saved hecause a checkpoint 
is still active. 


User Action: Deallocate the checkpoint file (see the ACS 
command) and reenter the SAVE command line. 


<taskname> Checkpoint space allocation failure 

Explanation: This is a TKTN message. The checkpoint file did 
not contain enough Space for the specified task to be 
checkpointed. 
-- Checkpoint space too small, using checkpoint file 

Explanation: This is a warning message only. The checkpoint 
Space allocated in the task image file is too small for the size 
of the task (usually because of the /INC keyword). The system 
supports the dynamic allocation of checkpoint space and will 
therefore use a checkpoint file to contain the checkpointed task. 
<taskname> <ddnn:> -- Checkpoint write error 


Explanation: This is a TKTN message. A write failure occurred 
while the system was attempting to checkpoint the specified task. 


-- Circular redirect error 


Explanation: The attempt to redirect a device would result in a 
circular list of redirections. 


XXX -- Command input error 


Explanation: Circumstances prevented the BROADCAST task from 
receiving the command line (usually an indirect command file 
could not be found); or, a system directive or the RUN command, 
rather than the HELLO command, has initiated the HELLO task; or 
an error occurred while MOUNT was attempting to read the command 
line. 


User Action: In the case of BROADCAST, reenter the command line. 


XXX -- Command I/0 error 


Explanation: An I/O error was encountered while the command line 
was being read. 


XXX -- Command syntax error 


Explanation: The command line had an improper format. 
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-- Command too long 


Explanation: An INI or MOUNT command, including continuation 
lines, exceeded the maximum length of 512(10) characters. 


-~- Common block is task partition <commonname> 


Explanation: A task's request for access to a common block was 
rejected because the requested partition was a task partition. 


-- Common block not loaded <commonname> 


Explanation: The specified common block was linked to the task 
but had not been installed in the system. 


User Action: Install the common block, then install the task. 
-- Common block occupied 


Explanation: An attempt was made to load a task into a common 
block that was already occupied. 


-- Common block parameter mismatch <commonname> 


Explanation: Parameters of a common block did not match those in 
the task's label block. 


-- Common block segment count error 


Explanation: The command installed a resident library with 
overlays, but the number of overlay segments specified in the 
task header is different from the number specified in the segment 
descriptors. 


heckpointable 


-- Common, driver or task above system image file limit 


Explanation: A system cannot be saved if addresses for a 
memory-resident structure are higher than the highest address of 
main memory written to the system image file. 


User Action: Use the PAR command to determine the cause of the 
problem. 
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XXX -- Data error 


Explanation: The specified bad-block number or the _ specified 
contiguous region size is too large. 


User Action: Reenter a valid number or size. 
XXX -- Device attached 
Explanation: The specified device cannot be allocated because it 


is attached to a running task or the CLI command cannot do a 
/SHOW display because the terminal is attached to another task. 


y 


4/0. Therefore 


XXX -- Device not allocated to this terminal 
Explanation: The command line specified a private device that 
was allocated to a terminal other than the one from which the 
command was issued. 


XXX -- Device not in system 


Explanation: The device specified in the command line is not in 
the current system configuration. 
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-- Device <dd:> not in system 

Explanation: The specified device driver does not exist in the 
system, or the data base for the device driver is not in the 
system or in the driver's task image. 
-- Device not mounted 

Explanation: The device specified in the file specification was 
not mounted. In response to a LOAD or UNLOAD command, the system 
device (LB:) was not mounted. 
-- Device not redirectable 

Explanation: The specified device cannot be redirected. 


-- Device not ready - <ddnn:> 


Explanation: The command line specified a volume that was not 
ready (not up to speed). 


-- Device not terminal 
Explanation: An attempt was made to set terminal characteristics 
for or the /TERM keyword was specified for a device that is not a 
terminal. 


-- Device not variable speed multiplexer 


Explanation: An attempt was made to set the baud rate for a 
terminal that was not attached to a DH11 or DZ11 multiplexer. 


-~- Device offline[-ddnn:] 


Explanation: The device specified in the command line, although 
generated into the system, was not physically present in the host 
configuration. If the off-line device is a magnetic tape drive, 
the message includes the device unit. 


-- Device write locked - <ddnn:> 

Explanation: The command line specified a volume that was 
write-locked. 
-- Directory already exists 

Explanation: The requested UFD already exists on the volume. 
-- Disk is alignment cartridge 

Explanation: The last track on an RK06/07, RLO1/02, or 
RM02/03/05/80/RP07 disk identified the volume as an alignment 
cartridge, which cannot be initialized as a Files-11 volume. An 
alignment cartridge is specifically formatted for aligning disk 
read/write heads. 

<ddnn:> -- Dismount complete 


Explanation: This is a TKTN message. This message indicates 
that the device requested for dismount is now logically 
disconnected from the system (that is, all files are deaccessed 
and the VCB is deallocated). 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


xxx - 


— Dynamic: allocation of checkpoint pipes not PEpeor red 


MCR AND TKTN MESSAGES 


-- DPB error 


Explanation: A bad Directive Parameter Block was created by MCR. 
This error indicates that the system itself has faulted. 


User Action: If the error persists, submit a Software 
Performance Report (SPR) to DIGITAL. 


-- Driver already resident 


Explanation: The specified device driver had already been loaded 
or is permanently resident. 


-- Driver being loaded or unloaded 


Explanation: The Executive was effecting another request to load 
or unload the driver. 


-- Driver built with wrong Executive STB file 


Explanation: The STB file for the driver was not compatible with 
the current Executive. 


-- Driver cannot be unloaded 
Explanation: The UNLOAD command attempted to remove a 


permanently resident device driver (that is, a driver built as 
part of the Executive). 


-- Driver load/unload calls not supported 


Explanation: The requested driver included the symbols S$ddLOA or 
SddUNL in its source. These symbols are reserved for future use 
by the LOAD and UNLOAD commands. 


-- Driver not loaded 
Explanation: The device driver specified in the UNLOAD command 
was not resident in memory, or the INI or MOUNT command specified 
a device for which a driver was not loaded. 


-- Duplicate block(s) found 


Explanation: A block that had been specified as bad was being 
defined as bad a second time. 


eu (RSX-11M systems only. 4 ‘the AGS command was issued 


on a syStem that did not include support of panic: allocation of 


ea checkpoint Space at system generation. 


XXX 


-- Error logging still active 


Explanation: A system cannot be saved while error logging is 
active. Disable error logging and reenter the SAVE command line. 
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XXX -- Failed to attach device - <ddnn:> 
Explanation: The specified device could not be attached. 
XXX -- Failed to create directory 


Explanation: No space existed on the volume or an I/O error 
occurred. 


XXX -- Failed to enter in MFD 


Explanation: No space existed in the Master File Directory (MFD) 
or on the volume, or an I/O error occurred on the volume. 


XXX -- Failed to read bad block file 


Explanation: The INI command was unable to read the bad _ block 
information from the last track of an RKO6/07, RLO1/02, or 
RM02/03/05/80/RP07 disk. 


XXX -- Feature not supported 
Explanation: The command keyword specified a feature or device 


that was not incorporated into the system at system generation, 
or the command itself cannot be used. 


XXX -- File <filename> has illegal STB format 
Explanation: The driver's STB file contained illegal object code 
or data. 

XXX -- File I/O error nnn. 


Explanation: The ACS command detected an error when it tried to 
allocate or open the checkpoint file. The code nnn. is an FCS 
error code that defines the cause of the error. See the 
IAS/RSX-11 I/O Operations Reference Manual. 


XXX -- File <filename> not a valid driver task image 


Explanation: The driver's task image was either overlaid or had 
a task header. 


XXX -- File not contiguous 
Explanation: An attempt was made to boot a system or install a 
task from a noncontiguous file. System images and task images 
must be contiguous. 


XXX -- File <filename> not contiguous 


Explanation: The file specified was not contiguous. The file 
must be contiguous. 


XXX -- File not found 


Explanation: The requested file was not in the directory on the 
specified volume. 


XXX -- File not in use 


Explanation: A checkpoint file was not in use on the _ device 
specified in the ACS command. 


A-10 


MCR AND TKTN MESSAGES 


XXX -- File not properly closed 
Explanation: An attempt was made to install a file that was not 


properly closed (that is, locked). Since the file is locked, it 
is probably corrupted. Install a new copy of the file. 
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-- File not task image 


’ 2 label block was not correct, indicating 
not a valid task image. 


-—- Home block allocate write error 


Explanation: A write error occurred while the system was 
overwriting a bad home-biock area. 


-- Home block I/O error 


Explanation: An error was detected in reading or writing the 
volume home block. 


Explanation: The device specified at task-build time by the 
assign (ASG) option does not exist in the system. This is a 
warning message only. 

-- Illegal device specified 

Explanation: The specified device was not a terminal. 


-- Illegal device/volume 


Explanation: The specified device was not a valid task-residence 
device. 


-- Illegal driver task APR usage 
Explanation: A device driver must be built for APR 5 and must be 
less than 8K (for example, PAR=DRVPAR:120000:40000). This 
message applies to mapped systems only. 
-- Illegal first APR 
Explanation: A privileged task, built to run using APR 4 or 5 as 
its base, was too large. Using APR 4, the task was larger than 
12K; using APR 5, the task was larger than 8K. 
If the Executive has been built to support 20K of address’ space, 
APR 5 is the only valid base APR for tasks mapping into the 
Executive. A privileged task that does not map into the 
Executive must use APR 0 as its base. (See the RSX-11M/M-PLUS 
Task Builder Manual for a description of the /PR keyword.) 
This message applies only to mapped systems. 


-- Illegal function 


Explanation: A command was entered that MCR could not’ recognize 
or an inappropriate keyword was specified. 
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-- Illegal keyword value 


Explanation: A string or value entered for a keyword was 
invalid. 


User Action: Enter a legal string or value. 
-- Illegal priority 


Explanation: The value of the priority in the command was out of 
range (that is, not 1 through 250 decimal). 


-- Illegal UIC 
Explanation: The command line specified an illegal UIC. 

-- Illegal value for symbol <symname> in file <filename> 
Explanation: The symbol symname is defined to an illegal value 
in the file ddDRV.STB. This can occur for several reasons, some 
general and some specific to individual symbols. For example, 
symbols cannot have odd values, most symbols cannot be defined as 
zero, SddTBL must exist and have a value less than SddEND, and 
mapped loadable drivers cannot reference SINTSV. 


-~ Improper help file format 


Explanation: The help file is not in proper format and cannot be 
used. Either edit the file or reenter it in the proper format. 


-- Index file bit map I/O error 


Explanation: An error was detected in writing the index-file 
bitmap. 


-- Index file header checksum error 


Explanation: While rebooting a saved system, the system detected 
a checksum error in the file header of the index file. The error 
causes the system to halt. The disk has probably been corrupted. 


-- Index file header read error 
Explanation: While rebooting a saved system, the system detected 
an error in the file header of the index file. The error causes 
the system to hait. 


~- Index file I/O error 


Explanation: An error was detected in writing the index-file 
header. 


-- Input I/O error 


Explanation: In attempting to read the next command, OPEN 
detected an error. 


-- Insufficient pool space 


Explanation: The required amount of pool space was not 
available. 
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does not. “point to one of the nonsense interrupt entries. This * 
"Message can appear: when you. issue the LOAD command. SSE 


XXX -- Invalid account 
Explanation: The name or UIC specified in the command line is 
not stored in the account file or the password specified does not 
match the name or UIC given. 

XXX -- Invalid address 
Explanation: The address specified as an argument by the OPEN 
command referenced a nonexistent memory location, an address 
outside of the specified partition, or an address outside of the 
task's virtual address space. 

XXX -- Invalid driver data base at offset <xxxx> in file <filename> 


Explanation: The driver had an invalid data base value at offset 
X¥Xxx relative to the symbol SddDAT. 


XXX -- Invalid keyword 


Explanation: A keyword was specified in the command line that 
cannot be used with the command. 


RX: d interrupt vector 


jon: (RSX-11M | lgyerens esl ye : 
specified. in the driver Sate pase was toc for the 
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XXX -- Invalid load device 


Explanation: The BOOT or INSTALL command detected a device that 
was invalid as a system- or task-residence device. 


XXX -- Invalid speed 
Explanation: The multiplexer line does not support the requested 
speed, or the command line specified unequal receive and transmit 
baud rates for a DZ11 or D2ZvV1l. The DZ11l and DZV11l do not 
Support split speeds. 

XXX -- Invalid time parameter 
Explanation: A specified time field was incorrect. 


XXX -- Invalid UIC 


Explanation: A value of zero was detected for either the group 
number or the member number. 


IOT execution 


Explanation: This is a TKTN message. The task executed an I0OT 
instruction and no SST routine was specified to process the trap. 
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-- I/0 error sizing device - <ddnn:> 


Explanation: The system encountered an I/O error while sizing an 
RF11 disk. 


-- Label block I/O error 


Explanation: In saving the system image, the SAVE command writes 
the transfer address in the label block of the system image file. 
An error occurred during this write attempt. The disk could be 
corrupted. 


-- Label block read error 


Explanation: The BOOT command could not read the label block of 
the system image. 


-- Length mismatch common block <blockname> 
Explanation: The length parameter for the common block, as 
described in the label block for the task image, did not match 
the corresponding length parameter defined in the system. A 
task's label block data must match system data for that task 
before it can be installed. 
-- Line not DZ11 


Explanation: The command attempted to set to remote a line that 
was not attached to a D211 multiplexer. 


-- Listing device not available 


Explanation: The device unit on which MCR was attempting to 
display information was attached and unavailable for use. 


-- Load device not LB:, task removed - <taskname> 


Explanation: The system removed the specified task while saving 
a system because the task had not been installed from LB:. 
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Load failure. Read error 


XXX -- Loadable driver support not in system 
Explanation: The system generation option to support loadable 
device drivers was not chosen or necessary routines are not in 
the Executive. 


XXX -- Logical device not in system 


Explanation: The specified logical device name was not defined 
in the logical device tables. 


XXX -- Logins are disabled 
Explanation: The system was in the process of Shutting down or 
the command SET /NOLOGON has been issued. A user cannot log in 
at these times. 

XXX -- LUN out of range 
Explanation: An attempt was made to reassign a LUN that was 
greater than the maximum number of LUNs allocated to the task 
when it was built. 


XXX -- Magtape label must be specified 


Explanation: An INI command attempted to initialize a magnetic 
tape without specifying the required volume label. 


XXX -- Magtape device error - <ddnn:> 


Explanation: While positioning a magnetic tape before 
initializing it, the system encountered an I/O error. 


XXX -- Magtape write error - <ddnn:> 


Explanation: While writing to the magnetic tape during 
initialization, the system encountered an I/O error. 


XXX -- MCR is not installed 


Explanation: When a system is booted, SAVE uses MCR to mount the 
system disk. Use VMR to install the MCR... task. 


*** Memory parity error in partition '<pname>' 
Explanation: This is a MTKTN message. The error logging 
subsystem detected a memory parity error in the _ specified 
partition. 

Memory protect violation 
Explanation: This is a TKTN message. The task encountered a 


memory protect violation and no _ SST routine was specified to 
process the trap. 
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-- Message file error nnn. 


Explanation: The system could not open the file LOGIN.TXT for a 
reason indicated by the FCS code nnn. See the IAS/RSX-11 I/0 
Operations Reference Manual for a definition of the FCS code. 
-- MFD file header I/O error 


Explanation: An error was detected in writing the Master File 
Directory (MFD) file header. 


-- MFD write error 


Explanation: An error was detected in writing a block to the 
Master File Directory. 


Micro code loader not installed 
Explanation: This is a TKTN message. For systems that include 


the KMC11 line printer driver (LKDRV), this message indicates 
that the task LPINIT is not installed in the system. 


-- New device not known to system 


Explanation: The new device specified by the REDIRECT command 
was not known to the system (that is, it does not exist in the 
device tables). 


-- No bad block data found 
Explanation: Although automatic bad-block specification was 
selected, no bad—-block file was found on the volume. This is a 
warning message only. 

-- No checkpoint space, assuming not checkpointable 

Explanation: This is a warning message only. The command 
attempted to install the task as checkpointable, but the task was 
not built as checkpointable and therefore had no checkpoint space 
allocated in its task image file. Because the system does not 
support the dynamic allocation of checkpoint space, it considers 
the task not to be checkpointable. 

-- No LUNS 


Explanation: A LUN command line specified a task that had no 
current logical unit number assignments. 


-- No pool space 


Explanation: The Executive could not currently satisfy MCR's 
request for dynamic memory. 


-- No room available in STD for new task 


Explanation: No dynamic memory is available for making an entry 


in the System Task Directory (STD). The task cannot be 
installed. 
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-- No transfer address 


Explanation: BOOT did not consider the file to be a system image 
file because the specified transfer address in the label block 
appears to be corrupted. 


-- No volume list 


Explanation: The command line specified a magnetic tape drive 
for which a mounted volume list does not exist. 


-- Non existent memory 


Explanation: An attempt was made to define a partition in 
nonexistent memory. 


RSX EMT execution 


Explanation: This is a TKTN message. The task executed an EMT 
instruction having an argument other than 377(8) or, in the case 
of a privileged task switching to system state, 376(8), and no 
SST routine was specified to process the trap. 


-- Not a system image 


Explanations: The BOOT command determined that the file was not a 
system image. . 


-- Not a valid save device 


Explanation: An attempt was made to save a system on a device 
that is not part of the system I/O data structures or SAVE does 
not support the device. 


-- Not enough APRs for task image 


Explanation: The Task Builder allows the user to specify the 
virtual base address of a task image as a multiple of 4K. 
Privileged tasks that access the Executive start at either 
virtual address 100000(8) for a 16K Executive or at virtual 
address 120000(8) for a 20K Executive. If the virtual base 
address is set too high, there are not enough APRS remaining to 
map the task image. (See the RSX-11M/M-PLUS Task Builder Manual 
for information on privileged tasks.) This message applies only 
to mapped systems. 


-- Not file structured device 


Explanation: The system does not support Files-11 on the 
specified device. 


-- Not Files-11 device 

Explanation: The command line specified a device that did not 
contain a Files-l1l1 disk. The specified device unit must contain 
a mounted Files-11 disk. 


<ddnn:> -- Not ready 


Explanation: This is a TKTN message. The specified device was 
not ready. 


A-17 


MCR AND TKTN MESSAGES 


XXX -- Null file header I/O error 


Explanation: An error was detected in writing null file headers 
to the index file. 


Odd address or other trap four 
Explanation: This is a TKTN message. The task executed a word 
instruction with an odd address or referenced a nonexistent 
memory location in an unmapped system, and no SST routine was 
specified to process the trap. 
XXX -- Old device attached 
Explanation: An attempt was made to redirect an attached device. 
XXX -- Old device mounted 
Explanation: An attempt was made to redirect a mounted device. 


XXX -- Old device not known to system 


Explanation: An attempt was made to redirect an unknown device 
(the device does not exist in the device tables). 


XXX -- Open file(s) on <ddnn:> 


Explanation: There are open files on ddnn:. Ensure that’ the 
Queue Manager is stopped. 


XXX -- Other user logged on 
Explanation: Another user is currently logged in on the 
terminal. Only one user at a time can be logged in ona 
terminal. 

XXX -- Output error 
Explanation: An MCR terminal-write operation failed. 


XXX -- Overlap seeks not supported 


Explanation: The command attempted to enable overlapped seek 
Support for other than a DM or an RH device controller. 


XXX -- Parameter conflict with already mounted volume 
Explanation: The volume was already mounted foreign and Files-11l 
access waS requested or the volume was mounted Files-1l and 
foreign access was requested. 

Parity error 
Explanation: This is a TKTN message. A parity error occurred 
while the task was executing. The task was fixed in memory so 
that the memory cannot be reused for another task. 


XXX -- Partition already exists 


Explanation: An attempt was made to define a partition with a 
name already in use. 
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XXX -- Partition busy 


Explanation: The partition in which the task was to be fixed was 
occupied, So the task could not be fixed. 


XXX == Partition <pnam 
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XXX -- Partition not common 


Explanation: A partition specified for a common area or library 
was not defined as a common partition. 


os 


XXX -- Partition <pname> not in system, defaulting to GEN 
Explanation: This is a warning message only. The specified 
partition does not exist, so the system attempts to install the 
task in the GEN partition. 


So ace tion <eremen noe Tn SyeCen task. Femowed = _ <taskname 


XXX -- Partition <pname> too small 


Explanation: The partition into which the driver was to be 
loaded was not large enough to contain it. 


XXX -- Partition too small to buffer information 
Explanation: The command resulted in excessive output to the 


buffer. The information in excess of the buffer size is not 
displayed. 
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Postmortem Dump not possible 


Explanation: This is a TKTN message. A Postmortem Dump was 
requested (or the task was built specifying a Postmortem Dump) , 
but the dump could not be generated. For example, the PMD task 
was not installed, the PMD task and the aborted task were in the 
same partition and not checkpointable, or there was not enough 
memory available. 


Postmortem Dump will be generated 


Explanation: This is a TKTN message that indicates that a 
Postmortem Dump was requested and will be generated. 


XXX -- Privileged command 


Explanation: A command that is available only to privileged 
users was issued by a nonprivileged user. 


XXX -- Privileged task larger than 12K 
Explanation: A privileged task was larger than 12K words. 


Privileged tasks on an unmapped system have a maximum size of 
12K. 


XXX -- Pseudo device error 


Explanation: The specified device is a pseudo device. Pseudo 
devices cannot be allocated. 


XXX -- Pseudo device redirect error 


Explanation: An attempt was made to redirect one pseudo device 
to another pseudo device. 


XXX -- Public device [- ddnn:] 
Explanation: The command attempted to allocate or initialize a 
public device. Public devices cannot be allocated or 
initialized. 

**kk <ddnn:> -- Read failure. Check hardware status 


Explanation: This is a TKTN message. The card reader driver 
detected a hardware error. 


XXX -- Region/partition <name> is a common 
Explanation: An attempt was made to load a device driver into a 


common partition or region. A device driver cannot be loaded 
into a common partition or region. 
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*kk <ddnn:> -- Replacement control task not installed 


Explanation; This is a TKTN message. While bringing the 
specified device on line or detecting a bad block on the device, 
the driver could not call the replacement control task (RCT) 
because it is not installed. Install RCT. 


Reserved inst execution 


Explanation: This is a TKTN message. The task executed an 
illegal instruction and no SST routine was specified to process 
the trap. 


*kk <¢<ddnn:> -- Select error 


Explanation: This is a TKTN message. The selected device was 
not ready or more than one drive had the same unit number. 


XXX -- Space used 


Explanation: An attempt was made to create a partition or a 
subpartition in a storage area already occupied. 


XXX -- Specified partition for common block 


Explanation: An attempt was made to install a task in a common 
block. 


XXX -- Specified partition too small 


Explanation: The task being installed was larger than the 
partition into which it was being installed. 


SST abort. Bad stack 


Explanation: This is a TKTN message. An SST cannot be effected 
because the SST parameters cannot be pushed onto the task's 
stack, or a stack overflow was detected in an unmapped system, as 
indicated by a nonzero value in the header guard word. 
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-- Storage bitmap file I/O error 


Explanation: An error was detected in writing out the storage 
allocation file header. 


-- Symbol <symname> is doubly defined by file <filename> 


Explanation: The symbol symname is defined twice in the 
specified file. Duplicate symbols are illegal. 


-- Symbol <symname> is undefined in file <filename> 


Explanation: The symbol symname was found in the specified file, 
but the symbol was not defined. 


-- Syntax error 


Explanation: This message generally indicates that the required. 
information was entered incorrectly. 


User Action: You can usually correct this condition by retyping 
the arguments according to the command specifications. 


-~- System may not boot correctly 


Explanation: The file [system-uic]SAV.TSK was not found on _ the 
boot device. If SAVE must be checkpointed to redirect and mount 
the booted device, the system disk will be overwritten, causing 
unpredictable results. 


-- Task active 


Explanation: The task used as the argument of the command was 
active. 


-- Task active in another system, task removed - <taskname> 
Explanation: The task is installed in another system as well as 
in the booted system. Since taskname is active and mapped to 
dynamic regions in the other system, it cannot be run in _ the 
booted system. 

-- Task already fixed 


Explanation: The task used as the argument of the FIX command is 
already fixed in memory. 


-- Task and partition bases mismatch 
Explanation: The base of the partition did not match the base of 


the task being installed. This message applies only to unmapped 
systems. 
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XXX -- Task being aborted 


Explanation: A request for the execution of a task was made, but 
the task was being aborted either because of an unrecoverable 
error or an abort command or directive issued by a user. 


oS 


s e 
XX -- Task being fixed 


Explanation: An attempt was made either to fix or to alter the 
priority of a task that was already being fixed. 


XXX -- Task checkpointable 


Explanation: An attempt was made to fix a checkpointable task in 
memory. A checkpointable task cannot be fixed in memory. 


Task exit with outstanding I/0 


Explanation: This is a TKTN message. The task exited with one 
or more outstanding I/O requests. Tasks should terminate all I/0 
operations before exiting. The system does, however, process all 
outstanding I/0. 


XXX -- Task file deleted, task removed — <taskname> 
Explanation: While rebooting a saved system, a file 
identification that appears in the Task Control Block (TCB) could 
not be found in the index file on the boot device. This 


indicates that the file has been deleted. 
XXX -- Task file header error, task removed - <taskname> 


Explanation: When SAVE read the task header to restore the LBN 
of the task file, the checksum was bad or there was a file number 
mismatch. MTherefore, the task was removed. 


XXX -- Task file header read error, task removed - <taskname> 


Explanation: The system removed the specified task because it 
encountered a failure while reading the task's file header. 


XXX -- Task header read error 


Explanation: The system detected an I/O error while reading ina 
task header to write the file identification into the TCB. This 
error causes the system to halt. 


XXX -- Task image already installed 


Explanation: The requested task image, which was checkpointable, 
had already been installed. On systems that do not support the 
dynamic allocation of checkpoint space, checkpointable tasks that 
do not have checkpoint space allocated can be installed only 
once; other tasks can be installed more than once (under 
different names) . 
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XXX -- Task image I/O error 


Explanation: INSTALL could not read the task image file or it 
could not rewrite the task image header. (The device is 
write-locked.) 


XXX -- Task image I/O error in file <filename> 


Explanation: The device is probably write-locked. MCR could not 
read the task image file or could not rewrite the task image 
header. 


XXX -- Task image virtual address overlaps common block <blockname> 


Explanation: The virtual addresses reserved for the task image 
overlap those reserved for the common block specified in the 
message. A corruption of the task image file probably caused the 
overlap. 


Task installed in more than one system 


Explanation: This is a TKTN message. The task image file has 
been installed in more than one_= system. The task's header 
contains pointers for the last system in which the task was 
installed. The pointers are not valid for the current system. 
Remove the task and reinstall it in the current system. 


XXX -- Task installed in partition 


Explanation: An attempt was made to eliminate a partition or 
subpartition that contains installed tasks. 


XXX -- Task marked for abort 


Explanation: A previous request has already been made to abort 
the specified task, but the abort has not yet occurred. The task 
marked for abort is probably not currently resident in memory or 
it has outstanding I/O. 

XXX -- Task name already in use 


Explanation: An attempt was made to install a task with the same 
name as one already in the system. 


XXX -- Task not active 
Explanation: The specified task is not currently active. 
XXX -- Task not fixed 


Explanation: An attempt was made to unfix a task that was not 
fixed or tc open a virtual location of a task that was not fixed. 


XXX -- Task not in system 
Explanation: The specified task has not been installed or the 


task was initiated by the install-run-remove option of the RUN 
command. 
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XXX -- Task not suspended 
te eae Oar ae L ~ aal ; 1 
Explanation: The task specified in the RESUME command line was 


not suspended. 


XXX -- Task <taskname> has outstanding I/0 


Explanation: A system cannot be saved if a task is waiting for 
I/O to complete. 
XXX -- Task <taskname> is active and checkpointed 


Explanation: You cannot save a system if it contains an active 
and checkpointed task. This restriction prevents a possible 
system crash because, if the task was installed in another system 
image file, the task image could be corrupted when the task was 
run in the second system. 


XXX -- Task <taskname> is connected to an interrupt vector 


Explanation: Disconnect the task from the interrupt vector or 
abort it, and reenter the SAVE command line. 


XXX -- Task <taskname> not installed from an LB: 
Explanation: All tasks must be installed from the system device 
(LB:). Use the TAS command to determine which tasks are not 
installed. Reenter the SAVE command line after removing the 
tasks or installing them from LB:. 

T-bit trap or BPT execution 
Explanation: This is a TKTN message. The task has either set 
the T-bit in the Processor Status Word or executed a Breakpoint 
Trap instruction, and no SST routine was specified to process the 
trap. 

XXX -- Terminal allocated to other user 
Explanation: The issuing terminal is already allocated to 
another user. A user cannot log in on a terminal allocated to 
Someone else. 

XXX -- TI redirect error 


Explanation: An attempt was made to redirect the pseudo device 
TI:. This device cannot be redirected. 


offspring tas! 
_ aborted. 2 = 
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XXX -- Too many common block requests 

Explanation: A task is limited to seven common block requests. 
XXX -- Too many LUNS 

Explanation: A task attempted to assign more than 255(10) LUNs. 
XXX -- Too many subpartitions 

Explanation: An attempt was made to assign more than seven 


subpartitions. A partition is limited to a maximum of seven 
subpartitions. 


TRAP execution 


Explanation: This is a TKTN message. The task executed a TRAP 
instruction and no SST routine was specified to process the trap. 


XXX -- Undefined common block <blockname> 


Explanation: A task referenced a common block that had not been 
defined in the system. Usually, this message indicates that the 
task was built for another system. 


XXX -- Undefined density selection 
Explanation: The command line specified an illegal density 
value. 

XXX -- Unit does not support 800 bpi 


Explanation: The command line specified 800 bpi for a drive that 
does not support 800 bpi. 


XXX -- Unit does not support 1600 bpi 


Explanation: The command line specified 1600 bpi for a drive 
that does not support 1600 bpi. 


XXX -~ Unit does not support 6250 bpi 


Explanation: The command line specified 6250 bpi for a drive 
that does not support 6250 bpi. 


XXX -- Unit does not support density switch 


Explanation: The command line specified multiple densities for a 
device that does have multiple-density capability. 


XXX ~- Unit does not support HIGH/LOW density selection 


Explanation: The command line specified HIGH or LOW density for 
a device for which the HIGH and LOW options are undefined. 
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XXX -- Unit is not at LOW density 
-ion: The command line specified that a floppy disk in an 

RX02 drive be initialized at LOW density, but the floppy was 
formatted at HIGH density. 

XXX -- Unit is not at HIGH density 
Explanation: The command line specified that a floppy disk in an 
RX02 drive be initialized at HIGH density, but the floppy was 
formatted at LOW density. 

XXX -- Unknown main partition 


Explanation: An attempt was made to define a subpartition in a 
nonexistent main partition. 


XXX -- Unknown help qualifier 


Explanation: The help file does not contain the last qualifier 
displayed in the command line below the error message. 


**k* <ddnn:> -- Unrecoverable hardware device error 


Explanation: This is a TKTN message. Error Logging recorded an 
unrecoverable hardware error. 


XXX -- User logged on terminal 


Explanation: The command attempted to allocate a terminal that 
has been logged in by another user. Logged-in terminals cannot 
be allocated. 


XXX -- Volume mounted Files-1] 


Explanation: An attempt was made to initialize a mounted 
Files-11 volume. Mounted Files-11 volumes cannot be initialized. 


XXX -- Volume name too long - (volume name) 


Explanation: The command line specified a volume label that 
exceeded six characters for magnetic tape devices or 12(10) 
characters for disk or DECtape devices. 


XXX -- Volume not mounted 


Explanation: An attempt was made to dismount or to create a _ UFD 
on a volume that is not mounted. A volume on which a UFD is to 
be created must be mounted. 
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XXX -- Volume not mounted by TI: 


Explanation: The command line specified a dismount operation for 
a volume that was not mounted from the issuing terminal or the 
command line specified the wrong device name for a magnetic tape 
set. 


XXX -- Volume{s) still mounted on <ddnn:> 
Explanation: A system with mounted volumes cannot be saved. 
User Action: To correct the problem, dismount the volumes and 
retry the command. The DEVICES command can be used to display 
the mounted volumes. 


XXX -- Volume structure not supported 


Explanation: RSX-11M/M-PLUS does not support the Files-11 
Structure level of the volume being mounted. 


In response to a SAVE command, while rebooting a saved system, 
the system determined from the disk's home block that the disk's 
Structure iS not supported by the current version of 
RSX-11M/M-PLUS. This error causes the system to halt. 


XXX -- Warning -- Block 0 is bad 
Explanation: Block 0 of the specified volume, the boot block, 


was bad. A bootable image cannot be placed on this volume. This 
is a warning message only. 


XXX - KRB <name> interrupt vector nnn in use 


‘tion: (RSX-11M—PLUS systems only.) An attem} je to 
driver that. specifies an interrupt vec 


to a nonsense interrupt entry point. addr is 
caused by a previously loaded driver tha: his 
et this message, LOAD has loaded the driv: tly, 
O ht on 


roblem must be corrected before the device 


tor <nnn> too 


XXX -- Warning - Loadable driver larger than 4K 


Explanation: Loadable drivers can be up to 8K words in length. 
The driver must explicitly map to any locations above 4K words. 
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-- (Warning) Nonexistent LUN assignment for task <taskname> 


ion: The physi vice which SAVE was attemp 

reassign a LUN does not exist in the booted system. his 
condition is resolved if the task performs a run-time assignment 
to the LUN; otherwise, the task will encounter an error 


condition when it attempts to use the LUN. 


Q 
cy 


ina 
ing 
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-- Warning - Privileged task overmaps the I/O page 


Explanation: A privileged task that is mapped into the Executive 
is usually also mapped into the I/O page to access the registers 
for the KT11 and other devices. Many tasks do not require this 
access and can use the additional 4K words of virtual address 
space for the task image. This message warns that a task that 
may require access to the I/O page might have grown too large. 


-- Write attributes failure 


Explanation: An error was encountered while the attributes of 
either the MFD or the newly created UFD were being written. 


<ddnn:> -- Write back caching data lost. Unit write locked 


Explanation: This is a TKTN message. When the specified device 
was brought on line, RCT detected that its cache contained 
corrupted data, so the device was write-locked for protection. 
After correcting the cache data, mount the device as 
write-enabled (MOUNT /WRITE). 


Note that every time the device is brought on line, TKTN will 
display this message. 


XXX -- Write check not supported 


Explanation: An attempt was made to support write checking on a 
device that does not support it. 


XXX -- Wrong volume label 


Explanation: The volume's current label and the label specified 
in the command line did not match. 
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8-bit character option, 3-179 ALLOCATE command, 3-12 
command line format, 3-12 
error message, 3-13 
example, 3-13 


/ABAUD keyword, keyword, 
SET command, 3-174 /TERM, 3-12 
ABORT command, 3-3 /TYPE, 3-12 
command line format, 3-3 Allocation, 
error message, 3-4 - generic, 3-12 
example, 3-4 <ALPHAN> symbol, 4-8 
keyword, ALTER command, 3-15 
/PMD, 3-4 command line format, 3-15 
/TERM, 3-4 example, 3-15 
Access code, 2-3 keyword, 
/ACCESS keyword, /PRI, 3-15 
INI command, 3-79 /RPRI, 3-15 
<ACCOUN> symbol, 4-12 /TERM, 3-15 
Account File Maintenance <ALTMOD> symbol, 4-8 
Program, American National Standards 
See ACNT Institute, 
ACNT, 2-24 See ANSI 
example, 2-25 Ancillary Control Processor, 
ACP, See ACP 
default, 3-117 ANSI, 
foreign, fiie specification, 
passing parameter, 3-126 quotation marks in, 1-2 
specifying, 3-121 eASK directive, 4-23 
/ACP keyword, example, 4-24 
MOUNT command, 3-121 © format, 4-23 
ACS command, 3-8 ~-ASKN directive, 4-24 
command line format, 3-8 example, 4-26 
error message, 3-9 format, 4-24 
example, 3-9 -ASKS directive, 4-26 
keyword, example, 4-27 
/BLKS, 3-8 format, 4-27 
ACTIVE command, 3-11 ASN command, 3-16 
command line format, 3-11 ASSIGN command, 3-16 
example, 3-11 command line format, 
keyword, nonprivileged, 3-17 
/ALL, 3-11 privileged, 3-17 
/TERM, 3-11 error message, 3-18 
ACTIVE TASK LIST command, 3-19 example, 3-18 
Address, keyword, 
CSR, /GBL, 3-17 
boot device, /LOGIN, 3-17 
specifying, 3-163 /TERM, 3-17 
/AFF keyword, Assignment, 
INSTALL command, 3-96 global, 2-12 
OPEN command, 3-139 local, 2-12 
ALL command, 3-12 logical unit number, 
/ALL keyword, changing, 3-146 
ACTIVE command, 3-11 displaying, 3-116 
/ALLOC keyword, logicali-device, 
UFD command, 3-228 deleting, 3-16 
ALLOCATE CHECKPOINT SPACE displaying, 3-16 
command, 3-8 global, 3-16 
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Assignment (Cont.) 
local, 3-16 
login, 3-16 
specifying, 3-16 

login, 2-12 

Asterisk wildcard, 

At sign (@), 4-1 

ATL command, 3-19 

command line format, 
example, 3-21 

Attach mode, 4-32 

Autobaud detection option, 
3-174 
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Backwards deletion option, 
3-177 
/BAD keyword, 
INI command, 3-79 
<BASLIN> symbol, 4-8 
Baud rate, 
autobaud detection option, 
3-174 
remote terminal, 
specifying, 3-200 
Specifying, 3-206 
~-BEGIN directive, 4-28 
format, 4-28 
Begin-End block, 4-3 
beginning, 4-28 
creating, 4-3 
ending, 4-35 
BLK command, 3-22 
/BLKS keyword, 
ACS command, 3-8 
BLOCK command, 3-22 
command line format, 
example, 3-22 
keyword, 
/TERM, 
Boot block, 
hardware, 
writing on system device 
3-162 
BOOT command, 3-23 
command line format, 
error message, 3-25 
example, 3-25 
BREAKPOINT TO XDT command, 
3-26 
BRK command, 3-26 
command line format, 
example, 3-26 
BRO command, 3-27 
/BRO keyword, 
SET command, 3-175 
BROADCAST command, 3-27 
command line format, 
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BROADCAST command (Cont.) 
display format, 3-29 
error message, 3-30 
example, 3-29 
option, 

ALL, 3-28 
LOG, 3-28 
Broadcast option, 

/BS keyword, 
MOUNT command, 

/BUF keyword, 
SET command, 

Buffer, 
typeahead, 

clearing, 2-18 

BYE command, 3-31 
command line format, 
error message, 3-32 
example, 3-32 
keyword, 

/HOLD, 
task, 
aborting, 
nonprivileged, 3-31 
privileged, 3-32 
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CANCEL command, 3-33 
command line format, 
example, 3-33 

CBD, 
information, 

displaying, 
removing region, 

CBD command, 3-34 
command line format, 
example, 3-35 
keyword, 

/TASKS, 

/CC keyword, 
MOUNT command, 

CHAIN directive, 
example, 4-29 
format, 

Character, 
control, 2-14 

OPEN command, 
lowercase, 

converting, 
translating, 

magnetic tape, 

Checkpoint, 
file, 

allocating, 3-8 
number of blocks, 

discontinuing, 3-8 
example, 3-8 

freeing, 3-9 
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Checkpoint (Cont.) 
space, 
allocating, 
/CKP keyword, 
INSTALL command, 3-96 
RUN command, 3-155 
/CLE keyword, 
SWR command, 
#GLIs 
CLI 
data structures, 
initializing, 
removing, 3-36 
default, 
resetting, 3-31 
specifying, 3-177 
disabling, 3-36, 3-38 
displaying, command line, 
4-3 
eliminating, 3-36 
enabling, 3-37 
information, 
displaying, 3-40 
installing, 3-97 
keyword, 
HELP command, 3-67 
INSTALL command, 3-97 
SET command, 3-177 
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setting up, 3-36 
status bit, 
list, 3-40 
switch, 
Indirect, 4-19 
CLI command, 3-36 


command line format, 3-36 
error message, 3-41 
example, 3-41 
keyword, | 
/DISABLE, 3-36 
/ELIM, 3-36 
/ENABLE, 3-37 
/INIT, 3-37 
/MESSAGE, 3-40 
/SHOW, 3-40 
/UNOVR, 3-41 
subkeyword, 
/CPR, 3-37 
/DISABLE, 
/DPR, 3-38 
/LGO, 3-38 
/MESSAGE, 3-39 
/NULL, 3-39 
/PRIV, 3-39 
/PROMPT, 3-39 
/QUIET, 3-39 
/RESTRICT, 3-40 
‘SNGL, 3-40 
3-40 
<CLI> symbol, 4-13 
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Clock queue, 
information, 
displaying, 3-43 
CLOCK QUEUE command, 3-43 
-CLOSE directive, 4-29 
format, 4-29 
CLQ command, 3-43 
command line format, 
example, 3-43 
/CMD keyword, 
RUN command, 
/COLOG keyword, 
_ SET command, 3-177 
COMMAN symbol, 4-17 
Command, 
library, 4-19 
default file type for, 
4-20 
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line, 
CLI, 
displaying, 4- 
comment in, 1-4 
compressing, 1-2 
extending, 1-2, 
format, 2-3 
Indirect, 4-21 
interpreter, 
See CLI 
parsing, 1-2, 
passing, 3-155 
processing, 
from another file, 
parallel, 3-205 
serial, 3-204 
quotation marks in, 1-2 
Substitution in, 4-17 
controlling format of, 
4-18 
terminating, 
MCR, 
summary, 
Parameter, 
procedure, 
DIGITAL-Supplied, 
invoking, 4-21 
universal library of, 
processing, 1-5 
COMMAND LINE INTERPRETER 
command, 3-36 
Comment, 1-4 
indirect command file with, 
4-3 
Common, 
library, 
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region, 
dispiaying, 
fixing, 3-55 
protecting, 


3 


2-4 


i-5, 4-46 


4-28 


1-2 


L=5 
1-2 


4-20 


4-19 


3-34 
3-34 


3-98 


Common (Cont.) 
read-only, 
specifying, 3-99 
Status bit, 
list, 3-34 
task, 
sharing, 3-100 
unfixing, 3-231 
COMMON BLOCK DIRECTORY 
command, 3-34 
Common Block Directory, 
See CBD 
<CONFIG> symbol, 
Continuation line, 1-2, 
Cantrol character, 2-14 
OPEN command, 3-138 
Control-Z mode, 4-32 
/CPR subkeyword, 
CLI command, 3-37 
/CPU keyword, 
OPEN command, 
/CRE keyword, 
FLA command, 
/CRT keyword, 
SET command, 
CSR, 
address, 
boot device, 
specifying, 3-163 
/CSR keyword, 
SAVE command, 
/CTB keyword, 
LOAD command, 
CTRL/C, 1-3, 
CTRL/I, 2-16 
CTRL/K, 2-16 
CTRL/L, 2-16 
CTRL/O, 2-16 
CTRL/Q, 2-17 
CTRL/R, 2-17 
CTRL/S, 2-17 
CTRL/U, 2-17 
CTRL/X, 2-18 
CTRL/Z, 2-18 
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~DATA directive, 4-29 
example, 4-30 
format, 4-30 

Data mode, 4-32 

Date, 
displaying, 3-226 
setting, 3-226 

<DATE> symbol, 4-13 

DCL, 
command, 

issuing, 3-44 
terminal, 
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DCL (Cont.) 
specifying, 3-178 
DCL command, 3-44 
command line format, 
example, 3-44 
/DCL keyword, 
HELP command, 
SET command, 
/DE switch, 
Indirect, 4-19 
DEALLOCATE command, 3-45 
command line format, 
example, 3-45 
DEBUG command, 3-46 
command line format, 
error message, 3-47 
example, 3-46 
~-DEC directive, 
example, 4-30 
format, 4-30 
Decimal mode, 
DECnet, 
UIC, 
specifying, 
DECtape, 
Files-ll, 
initializing, 3-78 
<DEFAUL> symbol, 4-8 
~DELAY directive, 4-30 
example, 4-31 
format, 4-31 
Delete, 
access, 2-3 
mode, 4-32 
DELETE key, 2-15 
/DENS keyword, 
HOME command, 
INI command, 
MOUNT command, 
Detach mode, 4-32 
DEV command, 3-48 
/DEV keyword, 
DISMOUNT command, 
TAS command, 3-224 
Device, 2-9 
allocating, 3-12 
generic, 3-12 
valid device, 
attribute, 4-52 
list of, 4-53 
boot, 
CSR address, 
specifying, 
bootable, 3-23 
compatible, 
buffer size, 
specifying, 
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Device (Cont.) 
specifying, 3-194 
deallocating, 3-45 
driver, 
loaded, 
testing, 4-41 
loading, 3-108 
pool requirements, 
unloading, 3-232 
file-structured, 3-117 
Files-ll, 2-1 
I/O request, 
redirecting, 
information, 
acquiring, 
file, 
displaying, 
name, 2-9 
logical, 2-11 
assigning, 2-12, 
syntax, 3-16 
symbolic, 
displaying, 3-48 
non-file-structured, 
null, 2-11 
private, 2-12 
releasing, 
specifying, 
pseudo, 2-10 
list, 2-10 
public, 2-12 
specifying, 2-13, 3-199 
redirecting, 2-10 
sequential, 3-117 
system, 
default, 2-2 
writing hardware boot 
block, 3-162 
unowned, 2-12 
specifying, 2-13 
write checking, 
specifying, 3-216 
DEVICES command, 3-48 
command line format, 
example, 3-48 
keyword, 
/LOG, 3-48 
DIGITAL COMMAND LANGUAGE 
command, 3-44 
/DIS keyword, 
SWR command, 
/DISABLE, 
keyword, 
CLI command, 
subkeyword, 
CLI command, 
-DISABLE directive, 
format, 4-31 
operating mode, 4-31 
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Disk, 
Files-1l, © 
directory, 
accessing, 
home block, 
modifying, 3-73 
initializing, 3-78 
protecting, 3-126 
floppy, 
density, 
checking, 3-73 
I/O queue optimization, 
specifying, 3-193 
DISMOUNT command, 3-51 
command line format, 
error message, 3-53 
example, 3-53 
keyword, 
/DEV, 
/LOCK, 3-52 
/USER, 3-52 
Display mode, 4-32 
DMO command, 3-51 
Dollar sign ($), 
/DPR subkeyword, 
CLI command, 3-38 
Driver, 
device, 
loaded, 
testing, 4-41 
loading, 3-108 
pool requirements, 
unloading, 3-232 
user-written, 
debugging, 
/DRV keyword, 
OPEN command, 
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/EBC keyword, 
SET command, 
/ECHO keyword, 
SET command, 3-180 
Echo option, 3-180 
/ELIM keyword, 

CLI command, 3-36 
FLA command, 3-57 
-ENABLE directive, 
example, 4-34 

format, 4-34 
operating mode, 
/ENABLE keyword, 
CLI command, 3-37 
-END directive, 4-35 
format, 4-35 
End-of-file, 
indicating, 2-18 
<EOF> symbol, 4-8 


3-179 


4-32 


4-32 


3-51 


37110 
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eERASE directive, 4-35 
example, 4-36 
format, 4-35 

<ERRCTL> symbol, 

<ERRNUM> symbol, 

Error, 

Indirect, 

processing, 4-43 

log file, 

inserting text, 3-221 

message, 

See Message 
<ERRSEV> symbol, 
<ERSEEN> symbol, 
ESC key, 2-15 
Escape recognition mode, 4-33 
Escape-sequence recognition, 

mode, 4-33 
option, 3-181 
<ESCAPE> symbol, 

/ESCSEQ keyword, 
SET command, 3-181 

/EST keyword, 
RUN command, 

Executive, 
data space, 

address, 

accessing, 
debugging, 3-26 
instruction space, 
address, 
accessing, 
Swapping, 
length, 
specifying, 3-208 
priority range, 
specifying, 3-209 
virgin, 

booting, 3-24 
Executive Debugging Tool, 

See XDT, 3-26 
~-EXIT directive, 
example, 4-36 
format, 4-36 

Exit status, 
Indirect, 

Expression, 
numeric, 4-14 

evaluating, 4-15 

Signed arithmetic in, 4-33 

string, 4-16 
<EXSTAT> symbol, 
<EXSTRI> symbol, 

/EXT keyword, 
HOME command, 
INI command, 3-81 
MOUNT command, 3-122 


ee _ 9 
Extend 2-3 


4-10 
4-10 


4-10 
4-8 


4-9 


3-155 


3-140 


3-140 


4-36 


4-10, 4-51 


3-74 


access, 


Index-6 


External header, 
task, 


specifying, 3-100 


<FALSE> symbol, 4-9 
/FDX keyword, 
SET command, 
/FIL keyword, 
HELP command, 
<FILATR> symbol, 
File, 2-1 
access code, 
assigning, 
type, 2-3 
user group, 
accessing, 2-2 
account, 
setting up, 
chaining to, 
checkpoint, 
allocating, 3-8 
number of blocks, 
discontinuing, 3-8 
example, 3-8 
freeing, 3-9 
determining existence of, 
4-53 
error log, 
inserting text, 3-221 
exiting from, 4-42 
extending, 3-81, 3-122 
default size, 
specifying, 
header, 2-2 
help, 
calling other files, 
contents, 
displaying, 
default, 3-67 
example, 3-70 
format, 3-68 
level number, 
qualifier, 
synonymous, 
index, 
accessing, 
header, 
allocating, 
LBN, 
specifying, 3-82 
multiheader, 3-83 
indirect command, 
See Indirect command file 
login-text, 3-62 
maximum number of, 
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4-13 
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2-24 
4-28 
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3-74 


3-69 
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3-68 
3-69 
3-128 
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File (Cont.) 
name, 2-4 
special character in, 2-4 
owner, 2-2 
processing, 
delaying, 4-30 
terminating, 4-42 to 4-43 


protecting, 2-2, 3-74, 3-82, 
3-123 
secondary, 
appending data to, 4-44 
closing, 4-29 
opening, 4-44 
for reading, 4-45 
outputting text to, 4-29 


specifying, 
v 
quotation marks in, 1-2 
default, 2-7 
example, 2-9 
format, 2-4 
wildcard, 2-6 
system, 
command, 3-59 
requirements, 
image, 
determining minimum 
size, 3-160 
type, 2-4 
Standard, 2-7 
list, 2-8 
version, 2-5 
window, 
mapping pointer, 
allocating, 3-76, 
3-130 
File Set Identifier, 
3-120 
overriding, 
<FILER2> symbol, 
<FILERR> symbol, 
Files-ll, 2-1 
magnetic tape, 2-1 
valid device, 2-1 
volume, 
bad block, 
entering, 3-80 
marking, 3-79 
directory, 
accessing, 
3-124 
home block, 
modifying, 
initializing, 
level, 3-84 
mounting, 3-117 
owner, 
specifying, 
preparing, 2-1 


3-60 


3-86, 
3-119 to 
3-125 


4-11 
4-11 


3-74, 3-84, 


at ee) 
3-78 


3-85 to 3-86 
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Files-1ll (Cont.) 


protecting, 3-86, 


Fill characters option, 3- 


vertical, 3-215 
<FILSPC> symbol, 4-13 
FIX-IN-MEMORY command, 

command line format, 3-5 

error message, 3-56 

example, 3-56 

keyword, 

/REG, 3-55 
/RON, 3-55 
FLA command, 3-57 
command line format, 

error message, 3-58 

example, 3-57 

keyword, 

/CRE, 
/ELIM, 
Flag, 
group global event, 
creating, 3-57 
displaying, 3-57 
eliminating, 3-57 
task status, 
displaying, 3-19 
list, 3-20 
<FMASK> symbol, 
7/FOR keyword, 

MOUNT command, 3-123 
<FORATT> symbol, 4-11 
-FORM directive, 4-7 
Form feed, 

hardware, 

specifying, 3-183 
/FORMFEED keyword, 

SET command, 3-183 
/FPRO keyword, 

HOME command, 

INI command, 

MOUNT command, 
Full-duplex option, 


S=5/ 
3=5'7 


a=57 


4-13 


3-74 
3-82 
3-123 
3-182 


/GBL keyword, 
ASSIGN command, 
Global symbol, 
defining, 4-3 
deleting definition of, 
mode, 4-32 
-GOSUB directive, 
example, 4-37 
format, 4-37 
-GOTO directive, 
example, 4-38 
format, 4-38 
/GRO keyword, 
HELP command, 


SaL7 


4-37 


4-37 


3-67 


3-126 


184 


3-55 


5 


3=57 


4-35 


INDEX 


Group, 
global event flag, 3-57 
creating, 3-57 
displaying, 3-57 
eliminating, 3-57 
group, 2-3 
user, 2-3 
GROUP GLOBAL EVENT FLAGS 
command, 3-57 


Hardware, 
boot block, 
writing on system device, 
3-162 
form feed option, 3-183 
horizontal tab option, 3-184 
/HDR3 keyword, 
MOUNT command, 3-123 
Header, 
file, 
index, 
allocating, 3-82 
task, 
external, 
specifying, 3-100 
HELLO command, 3-59 
command line format, 3-61 
error message, 3-64 
example, 3-63 
time limit, 3-61 
HELP command, 3-67 
command line format, 3-67 
error message, 3-71 
example of help file, 3-70 
keyword, 
/CLI, 3-67 
/DCL, 3-67 
/FIL, 3-67 
/GRO, 3-67 
/LOC, 3-67 
/MCR, 3-68 
/OUT, 3-68 
/XXX, 3-68 
Help file, 
calling other files, 3-69 
contents, 
displaying, 3-67 
default, 3-67 
example, 3-70 
format, 3-68 
level number, 3-68 
qualifier, 
synonymous, 3-69 
/HFILL keyword, 
SET command, 3-184 
/HHT keyword, 
SET command, 3-184 


/HIGH keyword, 
/LOAD command, 3-109 
/HOLD keyword, 
BYE command, 3-31 
SET command, 3-185 
Hold-screen mode option, 3-185 
HOME command, 3-73 
command line format, 3-73 
error message, 3-77 
example, 3-76 
keyword, 
/DENS, 3-73 
displaying, 3-76 
/EXT, 3-74 
/FPRO, 3-74 
/LRU, 3-74 
/MXF, 3-75 
/NAME, 3-75 
/OVR, 3-75 
/OWNER, 3-75 
/PRO, 3-75 
/UIC, 3-76 
/VI, 3-76 
/WIN, 3-76 


LL Ovy 
packet, 
maximum number, 
specifying, 3-191 
page, 
overmapping, 3-97, 3-156 
relative address, 
accesSing, 3-139 
queue optimization, 
specifying, 3-193 
valid device, 3-193 
request, 
redirecting, 3-147 
<IAS> symbol, 4-9 
-IF directive, 4-38 
example, 4-39 
format, 4-38 
-IFACT directive, 4-39 
example, 4-39 
format, 4-39 
-IFDF directive, 4-39 
example, 4-40 
format, 4-40 
-LFDISABLED directive, 4-40 
format, 4-40 
~LFENABLED directive, 4-40 
format, 4-40 
-IFF directive, 4-41 
example, 4-41 
format, 4-41 
-IFINS directive, 4-40 
example, 4-40 


Index-8 


-IFINS directive (Cont.) 
format, 4-40 
-IFLOA directive, 
example, 4-41 
format, 4-41 
-LFNACT directive, 
example, 4-39 
format, 4-39 
-IFNDF directive, 
example, 4-40 
format, 4-40 
-LIFNINS directive, 
example, 4-40 
format, 4-40 
-IFNLOA directive, 
example, 4-41 
format, 4-41 
-IFT directive, 
example, 4-41 
format, 4-41 
-INC directive, 
example, 4-42 
format, 4-42 
/INC keyword, 
INSTALL command, 3-97 
RUN command, 3-155 
Index file, 
accessing, 
header, 
allocating, 
LBN, 
specifying, 3-82 
multiheader, 3-83 
Indirect, 
command line, 
interpreting, 4-2 
directive, 
parameter, 
changing, 
Summary of, 4-4 
error message, 4-57 
error-processing, 4-10, 
example, 4-56 
exit status, 
function, 4-2 
invoking, interactively, 
example of, 4-56 
operating mode, 
disabling, 4-31 
enabling, 4-32 
initial setting, 
List,- 4=32 
testing, 4-40 
special symbol, 
format, 4-8 
logical, 4-8 
numeric, 4-10 
string, 4-12 
type, 4-8 


4-4] 


4-39 


4=39 


4-40 


4-41 


4-4] 


4-42 


3-128 


3-32 


spell 


Pf 


4-43 


4-51 


4-32 


4-8 
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Indirect (Cont.) 
switch, 4-19 
Indirect command file, 
acquiring information, 4-52, 
4-54 
block-structured, 
CLI, 4-2 
default file type for, 4-2 
initiating, 4-2 
nested, 4-2 
comment in, 4-3 
default name for, 
deleting, 4-19 
displaying trace of, 4-19 
exiting from, 4-51 
parameter, 
processing, 4-17 
passing commands in, to CLI, 
4-19 
processing, 
interrupting, 4-46 
suspending, 4-55 
terminating, 4-36, 4-51 
searching UIC for, 4-4 
task, 4-1 
default file type for, 
initiating, 4-1 
nested, 4-2 
task name in, 
using, 
example of, 4-56 
Indirect Command Processor, 
See Indirect 
/INDX keyword, 
INI command, 
/INF keyword, 
INI command, 3-82 
INI command, 3-78 
/INIT keyword, 
CLI command, 3-37 
INITVOLUME command, 
command line format, 
error message, 3-87 
example, 3-87 
keyword, 
/ACCESS, 3-79 
/BAD, 3-79 
/DENS, 3-81 
displaying, 3-86 
/EXT, 3-81 
/FPRO, 3-82 
/INDX, 3-82 
/INF, 3-82 
/LRU, 3-84 
/MXF, 3-84 
/OWNER, 3-85 
/PRO, 3-86 
/UIC, 3-86 
/VI, 3-86 


4-3 


4-4 


4-1] 


4-4 


3-82 


3-78 
3-78 


INDEX 


INITVOLUME command (Cont.) 
/WIN, 3-86 
Input, 
solicited, 2-14 
terminating, 2-15 
unsolicited, 2-14 
processing, 
parallel, 3-205 
serial, 3-204 
INSTALL command, 3-95 
command line format, 3-95 
error message, 3-101 
example, 3-101 
keyword, 
/AFF, 3-96 
/CKP, 3-96 
/CLI, 3-97 
/INC, 3-97 
/IOP, 3-97 
/PAR, 3-97 
/PMD, 3-98 
/PRI, 3-98 
/PRO, 3-98 
/RON, 3-99 
/ROPAR, 3-99 
/SEC, 3-99 
/SLV, 3-99 
/SYNC, 3-100 
/TASK, 3-100 
/TIME, 3-100 
/XHR, 3-100 
/IOP keyword, 
INSTALL command, 3-97 
’ RUN command, 3-156 


Key, 

special character, 2-14 
Keyword, 1-4 
/KNL keyword, 

OPEN command, 3-140 
/KNLD keyword, 

OPEN command, 3-140 
/KNLI keyword, 

OPEN command, 3-140 


Label, 
Indirect, 4-22 
Begin-End block with, 4-28 
branching to, 4-37 
defining, 4-22 
direct access, 4-22 
maximum number of, 4-22 
volume, 
Files-li, 
specifying, 3-75, 3-79 
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Label (Cont.) 
overriding, 3-75, 3-125 
/LABEL keyword, 

MOUNT command, 3-124 
/LB switch, 

Indirect, 4-19 
LBN, 

index file, 

specifying, 3-82 
/LGO subkeyword, 

CLI command, 3-38 
Library, 

command, 4-19 

default file type for, 
4-20 
common, 
displaying, 3-34 
resident, 
installing, 3-95 
UIC, 
specifying, 3-186 
universal, 
command procedures in, 
4-19 
/LIBUIC keyword, 

SET command, 3-186 
<LIBUIC> symbol, 4-13 
/LINES keyword, 

SET command, 3-187 
/LO switch, 

Indirect, 4-21 
LOAD command, 3-108 

command line format, 3-108 

error message, 3-110 

example, 3-109 

keyword, 

/CTB, 3-109 
/HIGH, 3-109 
/PAR, 3-108 
/SIZE, 3-109 

pool requirements, 3-110 
/LOC keyword, 

HELP command, 3-67 
Local symbol, 

accessing, 4-21 

Begin-End block with, 4-3, 

4-28 

deleting definition of, 4-35 

reserved, 4-17 
<LOCAL> symbol, 4-9 
/LOCK keyword, 

default value, 

specifying, 3-124 

DISMOUNT command, 3-52 

MOUNT command, 3-124 

option, 


Nounload, 3-52, 3-124 
Unioad, 3-53, 3-124 
Virtual, 3-53, 3-124 


/LOG keyword, 

DEVICES command, 3-48 
<LOGDEV> symbol, 4-14 
Logging in, 3-59 

disabling, 3-61 
Logging out, 3-31 
Logical, 

block number, 

See LBN 
end-of-file directive (/), 
4-42 
example, 
format, 
name, 
assigning, 3-16 
determining physical 
device associated 


4-43 
4-42 


with, 4-53 
syntax, 3-16 
symbol, 4-7 
defining, 4-48 
testing, 4-39, 4-41 
test, 4-38 
compound, 4-42 
example, 4-42 
unit number, 
See LUN 
LOGICAL UNIT NUMBERS command, 
3-116 
Login, 


See also Logging in 
disabling, 3-61, 3-187 
enabling, 3-187 
Silent, 3-59 
specifying, 3-39 
text file, 3-62 
LOGIN command, 3-59 
command line format, 
error message, 3-64 
example, 3-63 
time limit, 3-61 
/LOGIN keyword, 
ASSIGN command, 
/LOGON keyword, 
SET command, 
Logout, 
See also Logging out 
Silent, 3-31 
specifying, 3-39 
<LOGUIC> symbol, 4-14 
/LOWER keyword, 
SET command, 
Lowercase, 
character, 
converting, 
mode, 4-33 
/LRU keyword, 
HOME command, 
INI command, 


3-61 


3-17 


3-187 


3-137 
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3-74 
3-84 
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/LRU keyword (Cont.) 
MOUNT command, 3-124 
LUN, 2-10 
asSigning, 
assignment, 
changing, 3-146 
displaying, 3-116 
LUN command, 3-116 
command line format, 3-116 
error message, 3-116 
example, 3-116 


2-10 


Magnetic tape, 
access protection, 


specifying, 3-79 
ANSI, 
mounting, 3-119 


protection, 
overriding, 3-125 
specifying, 3-124 
block size, 
specifying, 3-122 
character translation, 
specifying, 3-127 
density, 
specifying, 3-81 
expiration date, 
overriding, 3-125 
Files-ll, 2-1 
initializing, 3-78 
owner, 
specifying, 
HDR3 label, 
specifying, 3-123 
mounting, 3-117 
record, 
number of characters, 
specifying, 3-126 
type, 
specifying, 
set, 3-119 
naming, 
unlabeled, 
specifying, 
/MAIN keyword, 
SET command, 
<MAPPED> symbol, 
Mapping pointer, 
file window, 
allocating, 
3-130 
Master File Directory, 
See MFD 
/MAXEXT keyword, 
SET command, 3-190 
/MAXPKT keyword, 
SET command, 3-191 


3-85 


3-122 
3-120 

s-124 
3-188 
4-9 


3-76, 3-86, 


/MC switch, 
Indirect, 
MCR, 
command, 
Summary, 1-5 
interface, 1-5 
mode, 4-32 
terminal, 
specifying, 3-192 
/MCR keyword, 
HELP command, 3-68 
SET command, 3-192 
Memory, 
accessing, 3-140 
<MEMSIZ> symbol, 4-11 
/MESSAGE, 
keyword, 
CLI command, 
subkeyword, 
CLI command, 
Message, 
command, 
ABORT, 3-4 
ACS, 3-9 
ALLOCATE, 3-13 
ASSIGN, 3-18 
BOOT, 3-25 
BROADCAST, 
BYE, 3-32 
CLI, 3-41 
DEBUG, 3-47 
DISMOUNT, 3-53 
FIX, 3-56 
FLA, 3-58 
HELLO, 3-64 
HELP, 3-71 
HOME, 3-77 
INI, 3-87 
INSTALL, 3-101 
LOAD, 3-110 
LOGIN, 3-64 
LUN, 3-116 
MOUNT, 3-131 
OPEN, 3-141 
REASSIGN, 3-146 
REDIRECT, 3-147 
REMOVE, 3-149 
RESUME, 3-150 
RUN, 3-159 
SAVE, 3-163 
SET, 3-218 
TAS, 3-225 
UFD, 3-229 
UNFIX, 3-231 
UNLOAD, 3-232 
Indirect, 4-57 
MCR, A-1l 
sending, 3-27 
time limit, 


4-19 


3-40 


3=39 


3-30 


3-27 


INDEX 
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Message (Cont.) 

TKTN, 3-5, A-l 

MFD, 2-2 

contents, 2-2 

Mode, 

Indirect operating, 
disabling, 4-31 
enabling, 4-32 
initial setting, 
list, 4-32 
testing, 4-40 


Monitor Console Routine, 


See MCR 
/MOU keyword, 
SAVE command, 3-163 
MOUNT command, 3-117 
command line format, 


ANSI magnetic tape, 3-119 


Files-ll, 3-118 
error message, 3-131 
example, 3-130 
keyword, 

/ACP, 3-121 

ANSI magnetic tape, 

/BS, 3-122 

fCOy 3-122 

/DENS, 3-122 

/EXT, 3-122 

Files-ll, 3-119 

/FOR, 3-123 

/FPRO, 3-123 

/HDR3, 3-123 

/LABEL, 3-124 

/LOCK, 3-124 

/LRU, 3-124 

/OVR, 3-125 

/OVRACC, 3-125 

/OVREXP, 3-125 

/OVRSFID, 3-125 

/PARM, 3-126 

/PRO, 3-126 

/PUB, 3-126 

/RS, 3-126 

/SHARE, 3-127 

/TR, 3-127 

/UIC, 3-127 

/UNL, 3-128 

/VI, 3-128. 

/VOL, 3-129 

/WAIT, 3-129 

/WIN, 3-130 

/WRITE, 3-130 


supported device, 3-117 


/MXF keyword, 
HOME command, 
INI command, 


3-75 
3-84 


4-32 


INDEX 


/NAME keyword, Operator, 

HOME command, 3-75 arithmetic, 4-14 
<NETNOD> symbol, 4-14 logicai, 4-14 
/NETUIC keyword, /OPT keyword, 

SET command, 3-192 SET command, 3-193 
<NETUIC> symbol, 4-14 /OUT keyword, 

/NULL subkeyword, HELP command, 3-68 
CLI command, 3-39 Output, 

<NUMBER> symbol, 4-9 displayed, 

Numeric symbol, 4-7, 4-14 resuming, 2-16 to 2-17 
decrementing, 4-30 suppressing, 2-16 
defining, 4-49 © suspending, 2-17 
incrementing, 4-42 displaying, 3-185 
radix of, 4-15 Overflow mode, 4-33 

redefining, 4-49 Overlap seek support, 

substituting, 4-15 specifying, 3-194 

testing, 4-39 valid device controller, 

<NXTSYM> symbol, 4-14 3-194 

Overlay, 
MCR, 1-5 
/OVLP keyword, 

<OCTAL> symbol, 4-9 SET command, 3-194 

-ONERR directive, 4-43 /OVR keyword, 
example, 4-44 HOME command, 3-75 
format, 4-43 MOUNT command, 3-125 

OPEN command, 3-138 /OVRACC keyword, 
command line format, 3-138 MOUNT command, 3-125 
control character, 3-138 /OVREXP keyword, 
error message, 3-141 MOUNT command, 3-125 
example, 3-141 /OVRFSID keyword, 
exiting, 3-139 MOUNT command, 3-125 
keyword, Owner group, 2-3 

/AFF, 3-139 /OWNER keyword, 
/CPU, 3-139 HOME command, 3-75 
/DRV, 3-139 INI command, 3-85 


/KNL, 3-140 
/KNLD, 3-140 
/KNLI, 3-140 


/PAR, 3-140 PAR command, 3-143 

/REG, 3-140 command line format, 3-144 

/TASK, 3-140 example, 3-144 to 3-145 
line terminator, 3-139 7PAR keyword, 

-OPEN directive, 4-44 INSTALL command, 3-97 
example, 4-44 LOAD command, 3-108 
format, 4-44 OPEN command, 3-140 

-OPENA directive, 4-44 RUN command, 3-156 
example, 4-45 SET command, 3-195 
format, 4-45 /PARM keyword, 

-OPENR directive, 4-45 MOUNT command, 3-126 
example, 4-45 -PARSE directive, 4-46 
format, 4-45 example, 4-46 

OPENREGISTER command, 3-138 format, 4-46 

Operating mode, Partition, 2-19 
Indirect, common, 3-189, 3-196 

disabling, 4-31 CPU, 

enabling, 4-32 relative address, 
initial setting, 4-32 accessing, 3-139 © 
list, 4-32 creating, 3-188, 3-195 
testing, 4-40 device, 3-189 
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INDEX 


Partition (Cont.) <PRIVIL> symbol, 4-9 
diagnostic, 3-196 Privilege, 
driver, terminal, 2-6, 2-18 
relative address, specifying, 3-198 
accessing, 3-139 /PRO keyword, 
eliminating, 3-190, 3-197 HOME command, 3-75 
information, INI command, 3-86 
acquiring, for command INSTALL command, 3-98 
file, 4-54 _ MOUNT command, 3-126 
displaying, 3-143 UFD command, 3-228 
main, 3-196 Prompt, 
creating, 3-188 explicit MCR, 1-3 
relative address, displaying, 2-16 
accessing, 3-140 specifying, 3-37 to 3-38 
system-controlled, 2-20, task, 2-14 
3-189 terminal, 
boundary, default, 2-14 
moving, 3-211 type, 2-13 
task, 3-189 /PROMPT subkeyword, 
type, 2-20, 3-143, 3-189, CLI command, 3-39 
3-195 /PUB keyword, 
user-controlled, 2-20, 3-189 MOUNT command, 3-126 
dividing, 2-20 SET command, 3-199 
PARTITION DEFINITIONS command, 
3-143 
Password, 
changing, 2-24 Quiet mode, 4-33 
-PAUSE directive, 4-46 /QUIET subkeyword, 
format, 4-46 CLI command, 3-39 
/PLCTL keyword, Quotation mark, 
SET command, 3-197 command line with, 1-2 
PMD, 


requesting, 3-4, 3-98, 3-156 
/PMD keyword, 


ABORT command, 3-4 <RAD50> symbol, 4-9 
INSTALL command, 3-98 REA command, 3-146 
RUN command, 3-156 Read access, 2-3 
Pool, »-READ directive, 4-47 
parameters, example, 4-47 
setting, 3-197 format, 4-47 
secondary, Read-pass-all option, 3-203 
installing task in, 3-99 REASSIGN command, 3-146 
use, command line format, 3-146 
displaying, 3-204 error message, 3-146 
size, example, 3-146 
displaying, 3-198 Record, 
increasing, 3-198 reading, 4-47 
/POOL keyword, REDIRECT command, 3-147 
SET command, 3-198 command line format, 3-147 
Postmortem Dump, error message, 3-147 
See PMD example, 3-147 
/PRI keyword, /REG keyword, 
ALTER command, 3-15 FIX command, 3-55 
INSTALL command, 3-98 OPEN command, 3-140 
RUN command, 3-157 REMOVE command, 3-149 
/PRIV keyword, UNFIX command, 3-231 
SET command, 3-198 Region, 
/PRIV subkeyword, common, 
CLI command, 3-39 displaying, 3-34 
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Region (Cont.) 
fixing, 3-55 
protecting, 
read-only, 

specifying, 3-99 
status bit, 
list, 3-34 
task, 
sharing, 3-100 
unfixing, 3-231 
relative address, 
accessing, 3-140 
removing, 3-149 
Register, 
Switch, 
bit; 
clearing, 3-222 
displaying, 3-222 
setting, 3-222 

REM command, 3-149 

/REMOTE keyword, 

SET command, 3-200 

REMOVE command, 3-149 

command line format, 
error message, 3-149 
example, 3-149 
keyword, 
/REG, 3-149 
RES command, 3-150 
Resident library, 
installing, 3-95 
/RESTRICT subkeyword, 
CLI command, 3-40 
RESUME command, 3-150 
command line format, 
error message, 3-150 
example, 3-150 
keyword, 
/TERM, 3-150 
»~RETURN directive, 
format, 4-48 

RETURN key, 2-15 

/RNDC keyword, 

command, 

keyword, 
command, 
keyword, 
command, 

/RON keyword, 

FIX command, 3-55 
INSTALL command, 3-99 
UNFIX command, 3-231 

/ROPAR keyword, 

INSTALL command, 3-99 
RUN command, 3-157 
Round-robin scheduling, 

length, 
specifying, 
priority, 


3-98 


3-149 


3-150 


4-48 


3-201 


3-202 


3-202 


3-201 


Index-15 
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Round-robin scheduling 


(Cont.) 
specifying, 3-202 
/RPA keyword, 
SET command, 3-203 


/RPRI keyword, 
ALTER command, 
/RS keyword, 
MOUNT command, 
/RSI keyword, 
RUN command, 3-153 
<RSX11D> symbol, 4-10 
RUN command, 3-151 
command line format, 
3-151 to 3-154 
error message, 3-159 
example, 3-158 
keyword, 
/CKP, 
/CMD, 
/EST, 
/INC, 
/IOP, 
/PAR, 
/PMD, 


5-15 


3-126 


3-155 
3-155 
3-155 
3=155 
3-156 
3-156 
3-156 
/PRI, 3-157 
/ROPAR, 3-157 
/RSI, 3-153 
/SLV, 3-157 
/TASK, 3-157 
/TIME,. 3=157 


/UIC, 3-151, 3-158 


SAVE command, 3-160 


command line format, 3-162 
error message, 3-163 
example, 3-163 
keyword, 
/CSR, 3-163 
/MOU, 3-163 
/SFILE, 3-163 
/WB, 3-162 
requirement, 3-161 
valid device, 3-160 
compatible, 3-160 
/SEC keyword, 
INSTALL command, 3-99 
Secondary file, 
appending data to, 4-44 
closing, 4-29 
opening, 4-44 
for reading, 4-45 
outputting text to, 4-29 
Secondary pool, 
installing task in, 3-99 


use, 


displaying, 3-204 


INDEX 


/SECPOL keyword, 
SET command, 3-204 
/SERIAL keyword, 


SET command (Cont.) 
option, 
nonprivileged, 3-170 
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SET command, 3-204 privileged, 3-170 
SET command, 3-170 /SET keyword, 
command line format, 3-171 SWR command, 3-222 
error message, 3-218 -SETD directive, 4-49 
keyword, example, 4-50 
/ABAUD, 3-174 format, 4-49 
/BRO, 3-175 -SETF directive, 4-48 
/BUF, 3-176 example, 4-48 
/CLI, 3-177 format, 4-48 
/COLOG, 3-177 ~SETL directive, 4-48 
/CRT, 3-177 example, 4-48 
/DCL, 3-178 format, 4-48 
/EBC, 3-179 ~SETN directive, 4-49 
/ECHO, 3-180 example, 4-49 
/ESCSEQ, 3-181 format, 4-49 
/FDX, 3-182 -SETO directive, 4-49 
/FORMFEED, 3-183 example, 4-50 
/HFILL, 3-184 format, 4-49 
/HHT, 3-184 SETS directive, 4-50 
/HOLD, 3-185 example, 4-50 
/LIBUIC, 3-186 format, 4-50 
/LINES, 3-187 -SETT directive, 4-48 
/LOGON, 3-187 example, 4-48 
/LOWER, 3-187 format, 4-48 
/MAIN, 3-188 /SFILE keyword, 
/MAXEXT, 3-190 SAVE command, 3-163 
/MAXPKT, 3-191 /SHARE keyword, 
/MCR, 3-192 MOUNT command, 3-127 
/NETUIC, 3-192 /SHOW keyword, 
/OPT, 3-193 CLI command, 3-40 
/OVLP, 3-194 /SIZE keyword, 
/PAR, 3-195 LOAD command, 3-109 
/PLCTL, 3-197 /SLAVE keyword, 
/POOL, 3-198 SET command, 3-205 
/PRIV, 3-198 /SLV keyword, 
/PUB, 3-199 INSTALL command, 3-99 
/REMOTE, 3-200 RUN command, 3-157 
/RNDC, 3-201 /SNGL subkeyword, 
/RNDH, 3-202 CLI command, 3-40 
/RNDL, 3-202 Space, 
/RPA, 3-203 checkpoint, 
/SECPOL, 3-204 allocating, 3-8 
/SERIAL, 3-204 <SPACE> symbol, 4-11 
/SLAVE, 3-205 Special symbol, 4-8 
/SPEED, 3-206 format, 4-8 
/SUB, 3-207 logical, 4-8 
/SWPC, 3-208 numeric, 4-10 
/SWPR, 3-209 string, 4-12 
/SYSUIC, 3-209 type, 4-8 
/TERM, 3-210 /SPEED keyword, 
/TOP, 3-211 SET command, 3-206 
/TYPEAHEAD, 3-213 SSM command, 3-221 
/UIC, 3-214 command line format, 3-221 
/VFILL, 3-215 example, 3-221 
/WCHK, 3-216 STD, 2-22, 3-95 
/WRAP, 3-217 entry, 


INDEX 


STD (Cont.) 
deleting, 3-149 
-STOP directive, 4-51 
example, 4-51 
format, 4-51 
String, 
constant, 4-16 
symbol, 4-7, 4-16 
defining, 4-50 
testing, 4-39 
<STRLEN> symbol, 4-11 
/SUB keyword, 
SET command, 3-207 
Subpartition, 2-20 
creating, 3-207 
eliminating, 3-208 
Subroutine, 
calling, 4-37 
returning from, 4-48 
Substitution, 4-17 
-enabling, 4-33 
format control, 4-18 
mode, 4-33 
Substring, 4-16 
searching for, 4-51 
Switch, 2-5 
argument, 2-5 
form, 2-5 
Indirect, 4-i9 
register, 
bli; 
clearing, 3-222 
displaying, 3-222 
setting, 3-222 
SWITCH REGISTER command, 3-222 
/SWPC keyword, 
. SET command, 3-208 
/SWPR keyword, 
' SET command, 3-209 
SWR command, 3-222 
command line format, 3-222 
example, 3-222 
keyword, 
/CLE, 3-222 
/DIS, 3-222 
/SET, 3-222 
<SYDISK> symbol, 4-14 
Symbol, 
defining, 4-3, 4-7 
displaying, 
example of, 4-56 
global, 
defining, 4-3 
deleting definition of, 
4-35 
local, 
accessing, 4-21 
Begin-End block with, 4-3, 
4-28 
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Symbol (Cont.) 
deleting definition of, 
4-35 
reserved, 4-17 
logical, 4-7 
defining, 4-48 
testing, 4-41 
name, 4-7 
numeric, 4-7, 4-14 
decrementing, 4-30 
defining, 4-49 
incrementing, 4-42 
radix of, 4-15 
redefining, 4-49 
Substituting, 4-15 
special, 4-8 
format, 4-8 
logical, 4-8 
numeric, 4-10 
String, 4-12 
type, 4-8 
string, 4-7, 4-16 
defining, 4-50 
substituting, 4-17 
table, 4-3 
deleting definition in, 
4-35 
free space in, 4-11 

testing, 4-38 to 4-39 

type, 4-7 

use, 4-7 
<SYMTYP> symbol, 4-11 
/SYNC keyword, 

INSTALL command, 3-100 
<SYSDEV> symbol, 4-14 
System, 

bootable, 3-23 

booting, 3-23 

restriction, 3-24 
valid device, 3-23 
virgin, 3-24 

command file, 3-59 

requirements, 3-60 
device, 
default, 2-2 
writing hardware boot 
block, 3-162 
group, 2-3 
image, 3-160 
file, 
determining minimum 
size, 3-160 
writing, 3-160 

logging in, 3-59 

logging out, 3-31 

multiuser protection, 

login, 
disabling, 3-187 
enabling, 3-187 


System (Cont.) 
saved, 
rebooting, 
saving, 3-160 
requirement, 
restriction, 
valid device, 
compatible, 
UIC, 
specifying, 3-209 
SYSTEM SERVICE MESSAGE 
command, 3-221 
System Task Directory, 
See STD 
<SYSTEM> symbol, 
/SYSUIC keyword, 
SET command, 3-209 
<SYSUIC> symbol, 4-14 
<SYUNIT> symbol, 4-11 


3-162 


3-161 

3-160 
3-160 
3-160 


4-11 


Tab, 
hardware horizontal, 
specifying, 3-184 
key, 2-16 
TAL command, 3-223 
command line format, 
example, 3-223 
TAS command, 3-224 
command line format, 
error message, 3-225 
example, 3-224 
keyword, 
/DEV, 
Task, 2-19 
aborting, 3-3 
active, 2-23 
aborting, 
displaying, 
information, 
displaying, 
testing, 4-39 
address, 
accessing, 
contents, 
changing, 3-138 
displaying, 3-138 
relative, 
accessing, 
attached, 2-14, 
blocking, 3-22 
canceling, 3-33 
catchall, 3-152 
checkpointing, 
CLI, 
installing, 
clock queue, 
displaying, 


3-223 


3-224 


3-224 


3-31 
3-11 


3=L9 


3-138 


3-140 
2-18 


2-20 
3-97 


3-43 
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INDEX 


Task (Cont.) 
command line, 
passing, 3-155 
common region, 
displaying, 
fixing, 3-55 
sharing, 3-100 
unfixing, 3-231 
CPU time limit, 
specifying, 3-100, 
creating, 2-21 
debugging, 3-46 
detaching, 2-18 
dormant, 2-23 
testing, 4-39 
dumping, 3-98 
exiting, 2-18 
extending, 3-97, 
maximum size, 
Specifying, 
external header, 
Specifying, 3-100 
fixing, 3-55 
restriction, 3-55 
install-run-remove, 
naming convention, 
running, 3-154 
installed, 2-22 
blocking, 3-22 
information, 
displaying, 
3-224 
testing, 4-40 
installing, 2-22, 
checkpointable, 
secondary pool, 
LUNS, 
reassigning, 
naming, 3-100, 
convention, 
overmapping I/O page, 
3-156 
parallel execution of, 
initiating, 4-55 
priority, 2-20 
changing, 3-15 
specifying, 3-98, 
prompt, 2-14 
prototype, 
running, 
removing, 
requesting, 
rescheduling, 
running, 2-23, 
checkpointable, 
Slaved, 
specifying, 
Status flag, 
displaying, 


3-34 


3-157 


3-155 


3-190 


2-23 


3-223 to 


3795 
3-96 
3-99 


3-146 
3=157 
2-21 to 2-22 
3=9 7), 


3-157 


3=151 

3-149 

2-21. C0: 2-22 
s=L53 

o= Lod 
3-155 


34-99, 3-157 


3-19 


Task (Cont.) 
list, 3-20 
suspended, 
continuing, 3-150 
Swapping, 2-20 
UIC, 
specifying, 3-158 
unattached, 2-14 
unblocking, 3-230 
unfixing, 3-231 
unstopping, 3-234 
Task Control Block, 
See TCB 
/TASK keyword, 
INSTALL command, 3-100 
OPEN command, 3-140 
RUN command, 3-157 
/TASK subkeyword, 
CLI command, 3-40 
Task Termination Notification 
program, 
See TKTN 
TASKLIST command, 3-224 
TASKLIST-ATL command, 3-223 
/TASKS keyword, 
CBD command, 3-34 
TCB, 3-95 
/TERM keyword, 
ABORT command, 3-4 
ACTIVE command, 3-11 
ALLOCATE command, 3-12 
ALTER command, 3-15 
ASSIGN command, 3-17 
BLOCK command, 3-22 
RESUME command, 3-150 
SET command, 3-210 
UNBLOCK command, 3-230 
UNSTOP command, 3-234 
Terminal, 2-13 
attached, 2-18 
baud rate, 
specifying, 3-206 
Cit, 
default, 
specifying, 3-177 
resetting, 3-31 
controlling operation, 2-14 
CRT, 
specifying, 3-177 
current line, 
deleting, 2-17 
retyping, 2-17 
DCL, 
specifying, 3-178 
dedicated, 2-19 
input, 
prompt, 2-13 
solicited, 2-14 
terminating, 2-15 
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Terminal (Cont.) 
unsolicited, 2-14 
local, 
specifying, 3-201 
logged-in, 
displaying, 3-48 
MCR, 
specifying, 3-192 
message, 
sending, 3-27 
time limit, 3-27 
option, : 
8-bit character, 3-179 
autobaud detection, 3-174 
backwards deletion, 3-177 
broadcast, 3-175 
echo, 3-180 
escape-sequence 
recognition, 3-181 
fill characters, 3-184 
vertical, 3-215 
full-duplex, 3-182 
hardware, 
form feed, 3-183 
horizontal tab, 3-184 
hold-screen mode, 3-185 
read-pass-all, 3-203 
typeahead, 3-213 
Wrap-around, 3-217 
output, 
resuming, 2-16 to 2-17 
Suppressing, 2-16 
suspending, 2-17 
paging, 3-187 
privilege, 2-6 
specifying, 3-198 
Status, 2-18 
remote, 3-200 
baud rate, 
specifying, 3-200 
slaved, 2-19 
specifying, 3-205 
text, 
deleting, 2-15 
displaying, 4-23 to 4-24, 
4-26 
type, 
half-duplex, 3-210 
specifying, 3-210 
Standard, 3-210 
typeahead, 
buffer, 
clearing, 2-18 
ULC; 
specifying, 3-214 
unattached, 2-18 
unit number, 2-21 to 2-22 
-TEST directive, 4-51 
example, 4-52 


-TEST directive (Cont.) 


INDEX 


UFD (Cont.) 


format, 4-51 default, 2-2 
eTESTDEVICE directive, 4-52 deleting, 2-2 
example, 4-53 format, 2-2 
format, 4-52 name, 2-2 
-TESTFILE directive, 4-53 protecting, 3-228 
example, 4-54 UFD command, 3-228 
format, 4-53 command line format, 3-228 
-TESTPARTITION directive, 4-54 error message, 3-229 
example, 4-54 example, 3-229 
format, 4-54 keyword, 
Text, /ALLOC, 3-228 
deleting, 2-15 /PRO, 3-228 
displaying, 4-23 to 4-24, UIC, 2-5 
-26 DECnet, 3-192 
<TICLPP> symbol, 4-11 default, 3-214 
<TICWID> symbol, 4-12 library, 3-186 
Time, setting, 
displaying, 3-226 nonprivileged, 2-6 
setting, 3-226 privileged, 2-6 
TIME command, 3-226 system, 3-209 
command line format, 3-226 task, 3-158 
example, 3-227 terminal, 3-214 
/TIME keyword, /UIC keyword, 
INSTALL command, 3-100 HOME command, 3-76 
RUN command, 3-157 INI command, 3-86 
<TIME> symbol, 4-14 MOUNT command, 3-127 
Timeout, RUN command, 3-151, 3-158 
count, 4-33 SET command, 3-214 
mode, 4-33 <UIC> symbol, 4-14 
<TIMOUT> symbol, 4-10 UNBLOCK command, 3-230 
<TISPED> symbol, 4-12 command line format, 3-230 
<TITYPE> symbol, 4-12 example, 3-230 
TKTN, 3-3 keyword, 
error message, 3-5, A-l /TERM, 3-230 
/TOP keyword, UNFIX command, 3-231 
SET command, 3-211 command line format, 3-231 
/TR keyword, error message, 3-231 
MOUNT command, 3-127 example, 3-231 
/TR switch, keyword, 
Indirect, 4-19 /REG, 3-231 
Trace mode, 4-33 /RON, 3-231 
<TRUE> symbol, 4-10 Universal library, 
Truncate mode, 4-33 command procedures in, 4-19 
/TYPE keyword, UNL command, 3-232 
ALLOCATE command, 3-12 /UNL keyword, 
Typeahead, MOUNT command, 3-128 
buffer, UNLOAD command, 3-232 
clearing, 2-18 command line format, 3-232 
option, 3-213 error message, 3-232 
/TYPEAHEAD keyword, example, 3-232 
SET command, 3-213 /UNOVR keyword, 
CLI command, 3-41 
UNSTOP command, 3-234 
command line format, 3-234 
UFD, 2-2 example, 3-234 
allocating space, 3-228 keyword, 


ee ee JD 
cConcenctS, 42-24 


creating, 2-2, 3-228 
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User File Directory, 
See UFD 


USER FILE DIRECTORY command, 


3-228 
User group, 2-3 
User Identification Code, 
See UIC 
/USER keyword, 
DISMOUNT command, 3-52 


Variable, 
testing, 4-51 
Vertical fill characters 
option, 3-215 
/VFILL keyword, 
SET command, 3-215 
/VI keyword, 
HOME command, 3-76 
INI command, 3-86 
MOUNT command, 3-128 
/VOL keyword, 
MOUNT command, 3-129 
Volume, 2-1 
dedicating, 3-127 
density, 
specifying, 3-122 
dismounting, 3-51 
Files-1ll, 2-1 
bad block, 
entering, 3-80 
marking, 3-79 
default protection, 


specifying, 3-75, 3-86, 


3-126 
directory, 


accessing, 3-74, 3-84, 


3-124 
home block, 
modifying, 3-73 
initializing, 3-78 
label, 
overriding, 3-75 


specifying, 3-75, 3-79 


level, 3-84 
owner, 
specifying, 3-75 to 


3-76, 3-85 to 3-86 


preparing, 2- 

Supported, 2- 
foreign, 2-1 

accessing, 2-1 

specifying, 3-123 
information, 

displaying, 3-128 
label, 

overriding, 3-125 


A. 
1 


Volume (Cont.) 
mounting, 3-117 
ACP, 
specifying, 3-121 
multiple times, 3-127 
operator assistance, 
requesting, 3-129 
owner, 
specifying, 3-127 
private, 3-118 
Public, 3-118 
accessing, 3-126 
Shared, 3-118 
unmounted, 
accessing, 3-117 
write-enabled, 
specifying, 3-130 
Volume Identifier, 3-119 
specifying, 3-129 


WAIT directive, 4-55 
example, 4-55 
format, 4-55 

/WAIT keyword, 

MOUNT command, 3-129 
/WB keyword, 

SAVE command, 3-162 
/WCHK keyword, 

SET command, 3-216 
Wildcard, 2-6 

asterisk, 2-6 
/WIN keyword, 

HOME command, 3-76 

INI command, 3-86 

MOUNT command, 3-130 
World group, 2-3 
/WRAP keyword, 

SET command, 3-217 
Wrap-around option, 3-217 
Write, 

access, 2-3 

checking, 

specifying, 3-216 

/WRITE keyword, 

MOUNT command, 3-130 


XDT, 
using, 3-26 
/XHR keyword, 
INSTALL command, 3-100 
-XQT directive, 4-55 
example, 4-56 
format, 4-56 
/*¥XX keyword, 
HELP command, 3-68 
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